WIP: Trajectory format

bindings/typescript/src/generated/Agent.ts

@@ -0,0 +1,4 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { UserContent } from "./UserContent";
+
+export type Agent = { name?: string, version?: string, metadata: Record<string, unknown>, instructions?: UserContent, };

bindings/typescript/src/generated/AgentResponse.ts

@@ -0,0 +1,5 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AssistantContent } from "./AssistantContent";
+import type { UniversalUsage } from "./UniversalUsage";
+
+export type AgentResponse = { response?: AssistantContent, usage?: UniversalUsage, start_time?: string, end_time?: string, };

bindings/typescript/src/generated/Compaction.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type Compaction = { id: string, replaced_message_count?: number, };

bindings/typescript/src/generated/EvidenceField.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type EvidenceField = "input" | "output" | "error";

bindings/typescript/src/generated/EvidencePart.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type EvidencePart = "reasoning" | "arguments";

bindings/typescript/src/generated/Finding.ts

@@ -0,0 +1,5 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FindingEvidence } from "./FindingEvidence";
+import type { FindingSeverity } from "./FindingSeverity";
+
+export type Finding = { title?: string, severity?: FindingSeverity, kind?: string, hypothesis?: string, root_cause?: string, next_steps?: Array<string>, evidence?: Array<FindingEvidence>, pattern_id?: string, };

bindings/typescript/src/generated/FindingEvidence.ts

@@ -0,0 +1,5 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { EvidenceField } from "./EvidenceField";
+import type { EvidencePart } from "./EvidencePart";
+
+export type FindingEvidence = { step_id: string, field?: EvidenceField, part?: EvidencePart, explanation?: string, quote?: string, highlight_terms?: Array<string>, leading_text?: string, trailing_text?: string, };

bindings/typescript/src/generated/FindingSeverity.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FindingSeverity = "critical" | "high" | "medium" | "low";

bindings/typescript/src/generated/InputTokenDetails.ts

@@ -0,0 +1,24 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModalityTokenCount } from "./ModalityTokenCount";
+import type { TokenBreakdown } from "./TokenBreakdown";
+
+/**
+ * Detailed subsets of inclusive prompt/input usage.
+ */
+export type InputTokenDetails = { 
+/**
+ * User/request content tokens by modality. Provider-generated tool prompts are separate.
+ */
+content_by_modality?: Array<ModalityTokenCount>, 
+/**
+ * Cache-read tokens, which are included in `UniversalUsage::prompt_tokens`.
+ */
+cached?: TokenBreakdown, 
+/**
+ * Cache-write tokens, which are included in `UniversalUsage::prompt_tokens` when reported.
+ */
+cache_creation?: TokenBreakdown, 
+/**
+ * Provider-generated tool prompt tokens included in `UniversalUsage::prompt_tokens`.
+ */
+tool_prompt?: TokenBreakdown, };

bindings/typescript/src/generated/LLMAnalysis.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Message } from "./Message";
+import type { UniversalParams } from "./UniversalParams";
+import type { UniversalUsage } from "./UniversalUsage";
+
+export type LLMAnalysis = { work?: Array<Message>, model?: string, params?: UniversalParams, usage?: UniversalUsage, };

bindings/typescript/src/generated/ModalityTokenCount.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TokenModality } from "./TokenModality";
+
+/**
+ * Token count for one modality.
+ */
+export type ModalityTokenCount = { modality?: TokenModality, token_count?: number, };

bindings/typescript/src/generated/OutputTokenDetails.ts

@@ -0,0 +1,16 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModalityTokenCount } from "./ModalityTokenCount";
+import type { TokenBreakdown } from "./TokenBreakdown";
+
+/**
+ * Detailed subsets of inclusive completion/output usage.
+ */
+export type OutputTokenDetails = { 
+/**
+ * Returned candidate content tokens by modality. Reasoning tokens are separate.
+ */
+content_by_modality?: Array<ModalityTokenCount>, 
+/**
+ * Reasoning/thinking tokens included in `UniversalUsage::completion_tokens`.
+ */
+reasoning?: TokenBreakdown, };

bindings/typescript/src/generated/Scope.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type Scope = { "type": "span", id: string, } | { "type": "trace", trace_id: string, } | { "type": "thread", key: string, value: string, };

bindings/typescript/src/generated/Section.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type Section = { name: string, description: string, step_ids: Array<string>, };

bindings/typescript/src/generated/TokenBreakdown.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModalityTokenCount } from "./ModalityTokenCount";
+
+/**
+ * A token subset with an optional modality breakdown.
+ */
+export type TokenBreakdown = { total_tokens?: number, by_modality?: Array<ModalityTokenCount>, };

bindings/typescript/src/generated/TokenModality.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A provider-independent token modality.
+ */
+export type TokenModality = "unspecified" | "text" | "image" | "audio" | "video" | "document";

bindings/typescript/src/generated/ToolResult.ts

@@ -0,0 +1,4 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ToolContentPart } from "./ToolContentPart";
+
+export type ToolResult = { input?: unknown, content?: Array<ToolContentPart>, };

bindings/typescript/src/generated/Trajectory.ts

@@ -0,0 +1,8 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Agent } from "./Agent";
+import type { Finding } from "./Finding";
+import type { Scope } from "./Scope";
+import type { Section } from "./Section";
+import type { Turn } from "./Turn";
+
+export type Trajectory = { scope: Array<Scope>, agent: Agent, sections?: Array<Section>, findings?: Array<Finding>, turns: Array<Turn>, metadata: Record<string, unknown>, version?: string, };

bindings/typescript/src/generated/Turn.ts

@@ -0,0 +1,8 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentResponse } from "./AgentResponse";
+import type { Compaction } from "./Compaction";
+import type { Message } from "./Message";
+import type { UniversalParams } from "./UniversalParams";
+import type { WorkStep } from "./WorkStep";
+
+export type Turn = { request_id: string, response_id?: string, request?: Array<Message>, response?: AgentResponse, work: Array<WorkStep>, model?: string, params?: UniversalParams, start_time: string, end_time?: string, interrupted?: boolean, compaction?: Compaction, };

bindings/typescript/src/generated/UniversalUsage.ts

@@ -0,0 +1,60 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { InputTokenDetails } from "./InputTokenDetails";
+import type { OutputTokenDetails } from "./OutputTokenDetails";
+
+/**
+ * Token usage statistics.
+ */
+export type UniversalUsage = { 
+/**
+ * Tokens in the prompt/input, including provider-generated tool prompts when reported.
+ */
+prompt_tokens?: number, 
+/**
+ * Tokens in the completion/output
+ */
+completion_tokens?: number, 
+/**
+ * Total tokens. Preserves a provider-reported value or falls back to prompt plus completion.
+ */
+total_tokens?: number, 
+/**
+ * Cached tokens in the prompt (from prompt caching)
+ */
+prompt_cached_tokens?: number, 
+/**
+ * Tokens written to cache during this request
+ */
+prompt_cache_creation_tokens?: number, 
+/**
+ * Tokens written to the 5-minute-TTL cache (Anthropic split cache writes)
+ */
+prompt_cache_creation_5m_tokens?: number, 
+/**
+ * Tokens written to the 1-hour-TTL cache (Anthropic split cache writes)
+ */
+prompt_cache_creation_1h_tokens?: number, 
+/**
+ * True when `prompt_tokens` excludes the cache read/creation buckets.
+ * Anthropic-style usage reports `input_tokens` exclusive of cache
+ * tokens, while OpenAI-style usage reports `prompt_tokens` inclusive of
+ * them. Consumers that want an OpenAI-style inclusive prompt total must
+ * add the cache buckets back when this is set; see
+ * [`UniversalUsage::inclusive_prompt_tokens`]. Consumers that want an
+ * Anthropic-style exclusive input count must subtract the cache buckets
+ * when this is not set; see [`UniversalUsage::exclusive_prompt_tokens`].
+ */
+prompt_tokens_exclude_cache?: boolean, 
+/**
+ * Reasoning/thinking tokens used in the completion.
+ * `Some(n)` only when `n > 0`; otherwise `None`.
+ */
+completion_reasoning_tokens?: number, 
+/**
+ * Detailed prompt/input token subsets and modality breakdowns.
+ */
+input_details?: InputTokenDetails, 
+/**
+ * Detailed completion/output token subsets and modality breakdowns.
+ */
+output_details?: OutputTokenDetails, };

bindings/typescript/src/generated/Work.ts

@@ -0,0 +1,6 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentResponse } from "./AgentResponse";
+import type { LLMAnalysis } from "./LLMAnalysis";
+import type { ToolResult } from "./ToolResult";
+
+export type Work = { "type": "agent_response" } & AgentResponse | { "type": "tool_result" } & ToolResult | { "type": "llm_analysis" } & LLMAnalysis;

bindings/typescript/src/generated/WorkStep.ts

@@ -0,0 +1,5 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Trajectory } from "./Trajectory";
+import type { Work } from "./Work";
+
+export type WorkStep = { id: string, span_type: string, name?: string, error?: unknown, start_time: string, end_time?: string, work: Work, sub_agent?: Trajectory, };

bindings/typescript/src/types.ts

@@ -42,3 +42,8 @@ export type { TokenBudget } from "./generated/TokenBudget";
 export type { ChatCompletionRequestMessage } from "./generated/openai/ChatCompletionRequestMessage";
 export type { InputItem } from "./generated/openai/InputItem";
 export type { InputMessage } from "./generated/anthropic/InputMessage";
+export type { Trajectory } from "./generated/Trajectory";
+export type { Turn } from "./generated/Turn";
+export type { WorkStep } from "./generated/WorkStep";
+export type { AgentResponse } from "./generated/AgentResponse";
+export type { UniversalUsage } from "./generated/UniversalUsage";

crates/lingua/Cargo.toml

@@ -34,7 +34,8 @@ serde_json.workspace = true
 bytes.workspace = true
 yaml_serde.workspace = true
 serde_with.workspace = true
-ts-rs.workspace = true
+chrono.workspace = true
+ts-rs = { workspace = true, features = ["chrono-impl"] }
 thiserror.workspace = true
 url.workspace = true
 urlencoding.workspace = true

crates/lingua/src/universal/mod.rs

@@ -19,6 +19,7 @@ pub mod response_format;
 pub mod stream;
 pub mod tool_choice;
 pub mod tools;
+pub mod trajectory;
 pub mod transform;
 
 // Re-export main types for convenience

crates/lingua/src/universal/request.rs

@@ -91,7 +91,7 @@ pub enum TokenBudget {
 ///
 /// Uses canonical names - adapters handle mapping to provider-specific names.
 /// Provider-specific fields without canonical mappings are stored in `extras`.
-#[derive(Debug, Clone, Default, Serialize, TS)]
+#[derive(Debug, Clone, Default, Serialize, Deserialize, TS)]
 #[ts(export)]
 pub struct UniversalParams {
     // === Sampling parameters ===
@@ -509,7 +509,7 @@ impl AsRef<str> for SummaryMode {
 /// - OpenAI Chat: `"auto"` | `"none"` | `"required"` | `{ type: "function", function: { name } }`
 /// - OpenAI Responses: `"auto"` | `{ type: "function", name }`
 /// - Anthropic: `{ type: "auto" | "any" | "none" | "tool", name?, disable_parallel_tool_use? }`
-#[derive(Debug, Clone, Default, Serialize, TS)]
+#[derive(Debug, Clone, Default, Serialize, Deserialize, TS)]
 #[ts(export)]
 pub struct ToolChoiceConfig {
     /// Selection mode - the semantic intent of the tool choice
@@ -520,7 +520,7 @@ pub struct ToolChoiceConfig {
 }
 
 /// Tool selection mode (portable across providers).
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, TS)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, TS)]
 #[ts(export)]
 pub enum ToolChoiceMode {
     /// Provider decides whether to use tools
@@ -595,7 +595,7 @@ impl AsRef<str> for ToolChoiceMode {
 /// - OpenAI Responses: nested under `text.format`
 /// - Google: `response_mime_type` + `response_schema`
 /// - Anthropic: `{ type: "json_schema", schema, name?, strict?, description? }`
-#[derive(Debug, Clone, Default, Serialize, TS)]
+#[derive(Debug, Clone, Default, Serialize, Deserialize, TS)]
 #[ts(export)]
 pub struct ResponseFormatConfig {
     /// Output format type
@@ -615,7 +615,7 @@ impl ResponseFormatConfig {
 }
 
 /// Response format type (portable across providers).
-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, TS)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, TS)]
 #[ts(export)]
 pub enum ResponseFormatType {
     /// Plain text output (default)
@@ -666,7 +666,7 @@ impl AsRef<str> for ResponseFormatType {
 }
 
 /// JSON schema configuration for structured output.
-#[derive(Debug, Clone, Serialize, TS)]
+#[derive(Debug, Clone, Serialize, Deserialize, TS)]
 #[ts(export)]
 pub struct JsonSchemaConfig {
     /// Schema name (required by OpenAI)