@arden-hq/loop 0.0.0-stage → 0.1.2

package/dist/contracts/messages.d.ts

@@ -0,0 +1,234 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | ReadonlyArray<JsonValue> | {
+    readonly [key: string]: JsonValue;
+};
+export type JsonObject = Readonly<Record<string, JsonValue>>;
+export type Metadata = Readonly<Record<string, unknown>>;
+export type MaybePromise<A> = A | PromiseLike<A>;
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+export declare namespace StandardSchemaV1 {
+    interface Props<Input = unknown, Output = Input> {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    interface SuccessResult<Output> {
+        readonly value: Output;
+        readonly issues?: undefined;
+    }
+    interface FailureResult {
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    interface Issue {
+        readonly message: string;
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    interface PathSegment {
+        readonly key: PropertyKey;
+    }
+    interface Types<Input = unknown, Output = Input> {
+        readonly input: Input;
+        readonly output: Output;
+    }
+    type InferInput<S extends StandardSchemaV1> = NonNullable<S["~standard"]["types"]>["input"];
+    type InferOutput<S extends StandardSchemaV1> = NonNullable<S["~standard"]["types"]>["output"];
+}
+export interface TextContent {
+    readonly type: "text";
+    readonly text: string;
+}
+export interface ImageContent {
+    readonly type: "image";
+    readonly media_type: string;
+    readonly data: string;
+}
+export interface AudioContent {
+    readonly type: "audio";
+    readonly media_type: string;
+    readonly data: string;
+}
+export interface ContextContent {
+    readonly type: "context";
+    readonly content_type: string;
+    readonly content?: string | null;
+    readonly metadata?: Readonly<Record<string, string>> | null;
+}
+export type ContentBlock = TextContent | ImageContent | AudioContent | ContextContent;
+export type ModelContentBlock = ContentBlock;
+export interface FunctionCall {
+    readonly name: string;
+    readonly arguments: string;
+}
+export interface ToolCall {
+    /** Native wire flag, preserved on replay. */
+    readonly async?: boolean;
+    readonly id: string;
+    readonly type: "function";
+    readonly function: FunctionCall;
+    readonly started_at?: number;
+    readonly parent_id?: string | null;
+    /** Sanitized display title the model wrote through the host's opt-in
+     *  argument (`CreateToolsetOptions.displayTitle`); never a tool argument.
+     *  Host fields from `AgentOptions.persistHost` ride beside it. */
+    readonly display_title?: string;
+}
+export type AssistantTextPhase = "commentary" | "final_answer";
+export type InteractionActorType = "agent" | "workflow" | "tool" | "harness" | "user";
+export interface InteractionActor extends JsonObject {
+    readonly type: InteractionActorType;
+    readonly id: string;
+    readonly display_name?: string;
+}
+export interface InteractionReference extends JsonObject {
+    readonly type: "message" | "run" | "tool_call" | "workflow";
+    readonly id: string;
+}
+/** Immutable model-facing snapshot of the message a human replied to. */
+export interface ReplyContext extends JsonObject {
+    readonly messageId: string;
+    readonly role: "user" | "assistant";
+    readonly content: string;
+}
+interface InteractionBase extends JsonObject {
+    readonly from: InteractionActor;
+    readonly to: InteractionActor;
+    readonly content: string;
+    /** One plain line for a person's row when `content` is written for the
+     *  recipient model; the row falls back to `content`. */
+    readonly preview?: string;
+    readonly causedBy?: InteractionReference;
+}
+/** `interrupted`: the sender stopped because the host restarted. */
+export declare const INTERACTION_OUTCOMES: readonly ["completed", "failed", "cancelled", "needs_attention", "interrupted"];
+type InteractionOutcome = (typeof INTERACTION_OUTCOMES)[number];
+/** Provider-neutral communication delivered by the harness. */
+export type Interaction = (InteractionBase & {
+    readonly kind: "message" | "assignment" | "event" | "instruction";
+}) | (InteractionBase & {
+    readonly kind: "completion";
+    readonly outcome: InteractionOutcome;
+});
+export type AssistantOutputPart = {
+    readonly type: "reasoning";
+    readonly text: string;
+} | {
+    readonly type: "text";
+    readonly text: string;
+    readonly phase?: AssistantTextPhase;
+} | {
+    readonly type: "tool_call";
+    readonly tool_call_id: string;
+    readonly execution: "runtime" | "provider";
+};
+/**
+ * The fields the loop itself reads on any stored message. Everything else a
+ * host keeps on a message rides the open record and round-trips untouched.
+ */
+interface MessageFields extends Metadata {
+    readonly message_id?: string;
+    /** Host idempotency key; the loop writes `tool-media:` and `async-result:` envelopes. */
+    readonly client_id?: string;
+    /** A harness-written envelope rather than authored text. */
+    readonly is_meta?: boolean;
+}
+/** Durable record that a background call was launched and how its result returns. */
+export interface AsyncToolLaunch {
+    readonly call_id: string;
+    readonly delivery: "native" | "message";
+}
+export interface SystemMessage extends MessageFields {
+    readonly role: "system";
+    readonly content: string | ReadonlyArray<Metadata>;
+}
+/** Current high-priority context that belongs in the request timeline, not the stable base prompt. */
+interface DeveloperMessage extends MessageFields {
+    readonly role: "developer";
+    readonly content: string | ReadonlyArray<Metadata>;
+    /**
+     * Deferred tools that stay loaded after a compaction removed the history
+     * that loaded them. A provider renders them in its own form; `content`
+     * is the plain-text fallback.
+     */
+    readonly loaded_tools?: ReadonlyArray<string>;
+    /**
+     * Deferred tools that left the catalog at this point in the conversation.
+     * They no longer count as loaded; if one returns, a search loads it again.
+     */
+    readonly removed_tools?: ReadonlyArray<string>;
+}
+export interface UserMessage extends MessageFields {
+    readonly role: "user";
+    readonly content?: string | null | ReadonlyArray<Metadata>;
+    /** Durable carrier; provider preparation derives the actual model role/item. */
+    readonly interaction?: Interaction;
+    readonly replyTo?: ReplyContext;
+    readonly async_tool_launch?: AsyncToolLaunch;
+    /** On the correction `hooks.checkFinalText` appended: the assistant records
+     *  of the answer it sent back. Durable with the history, so a host that
+     *  resumes the run knows the check already ran and what it replaced. */
+    readonly rejected_message_ids?: ReadonlyArray<string>;
+}
+export interface AssistantMessage extends MessageFields {
+    readonly role: "assistant";
+    readonly content?: string | null | ReadonlyArray<Metadata>;
+    readonly tool_calls?: ReadonlyArray<ToolCall>;
+    /** Calls the provider executed upstream, persisted with their results. */
+    readonly provider_tool_calls?: ReadonlyArray<ProviderToolCall> | null;
+    readonly reasoning_content?: string | null;
+    /** Provider-neutral presentation order for this model turn. */
+    readonly output_parts?: ReadonlyArray<AssistantOutputPart>;
+    /** Opaque replay state, keyed by the provider that wrote it. */
+    readonly provider_state?: ProviderState;
+}
+export interface ToolResultMessage extends MessageFields {
+    readonly role: "tool";
+    readonly tool_call_id: string;
+    readonly content: string;
+    readonly async_tool_launch?: AsyncToolLaunch;
+}
+export type ChatMessage = SystemMessage | DeveloperMessage | UserMessage | AssistantMessage | ToolResultMessage;
+export type ModelMessage = ChatMessage;
+export type Role = "system" | "developer" | "user" | "assistant" | "tool";
+export interface ProviderToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly arguments?: Readonly<Record<string, JsonValue>>;
+    readonly result?: string;
+    readonly done?: boolean;
+    readonly loaded_tool_names?: ReadonlyArray<string>;
+    /** Bounded provider evidence projected onto tool lifecycle events. */
+    readonly source_refs?: ReadonlyArray<JsonObject>;
+}
+/**
+ * Provider-owned replay state, keyed by provider id. The loop persists it on
+ * the assistant message untouched; only the provider that wrote an entry
+ * reads it back.
+ */
+export type ProviderState = Readonly<Record<string, JsonValue>>;
+/** Allocate opaque message identities with the platform Web Crypto API. */
+export declare const messageId: (kind: "text" | "reasoning" | "tool" | "tool-media" | "tool-load" | "tool-change") => string;
+/**
+ * Host-supplied identity scheme for streamed text and reasoning messages,
+ * applied at emission: the first event carrying a message already uses its
+ * durable id, so deltas, terminal events, and persisted history agree by
+ * construction. Minting is positional — `turn` is the model-call ordinal
+ * within the run, `fragment` the ordinal of the output fragment the message
+ * belongs to (always 0 for a provider that does not emit `OutputItemReady`),
+ * and `index` the per-kind ordinal within that fragment. The fragment is
+ * persisted as its own history record under `("text", { turn, fragment,
+ * index: 0 })`, so a scheme that derives a record's part ids from its record
+ * id names each streamed part the way history will. A provider retry
+ * discards the attempt and re-requests the same coordinates, so a pure
+ * scheme re-mints exactly the retracted ids.
+ */
+export type MessageIdMinter = (kind: "text" | "reasoning", position: {
+    readonly turn: number;
+    readonly fragment: number;
+    readonly index: number;
+}) => string;
+export {};
+//# sourceMappingURL=messages.d.ts.map

package/dist/contracts/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/contracts/messages.ts"],"names":[],"mappings":"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"}

package/dist/contracts/messages.js

@@ -0,0 +1,11 @@
+/** `interrupted`: the sender stopped because the host restarted. */
+export const INTERACTION_OUTCOMES = [
+    "completed",
+    "failed",
+    "cancelled",
+    "needs_attention",
+    "interrupted"
+];
+/** Allocate opaque message identities with the platform Web Crypto API. */
+export const messageId = (kind) => `${kind}-${globalThis.crypto.randomUUID()}`;
+//# sourceMappingURL=messages.js.map

package/dist/contracts/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/contracts/messages.ts"],"names":[],"mappings":"AAsIA,oEAAoE;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW;IACX,QAAQ;IACR,WAAW;IACX,iBAAiB;IACjB,aAAa;CACL,CAAA;AAgIV,2EAA2E;AAC3E,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAgF,EACxE,EAAE,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAA"}

package/dist/contracts/provider.d.ts

@@ -0,0 +1,177 @@
+import type { AssistantOutputPart, ChatMessage, Interaction, MaybePromise, ProviderState, ProviderToolCall, ToolCall, UserMessage } from "./messages.js";
+import type { JsonSchema, ToolDeclaration, ToolSearch } from "./tools.js";
+export declare const ToolChoice: {
+    readonly AUTO: "auto";
+    readonly NONE: "none";
+    readonly REQUIRED: "required";
+};
+export type ToolChoice = (typeof ToolChoice)[keyof typeof ToolChoice];
+export declare const FinishReason: {
+    readonly STOP: "stop";
+    readonly TOOL_CALLS: "tool_calls";
+    readonly LENGTH: "length";
+    readonly CONTENT_FILTER: "content_filter";
+};
+export type FinishReason = (typeof FinishReason)[keyof typeof FinishReason];
+export interface Usage {
+    readonly prompt_tokens: number;
+    readonly completion_tokens: number;
+    readonly cache_read_tokens: number;
+    readonly cache_write_tokens: number;
+}
+export declare const zeroUsage: () => Usage;
+export declare const usageInputTokens: (usage: Partial<Usage>) => number;
+export declare const addUsage: (left: Usage, right: Partial<Usage>) => Usage;
+export interface TextContentDelta {
+    readonly _tag: "TextDelta";
+    readonly content: string;
+}
+export interface ReasoningContentDelta {
+    readonly _tag: "ReasoningDelta";
+    readonly content: string;
+}
+export interface ToolCallStreamDelta {
+    readonly _tag: "ToolCallDelta";
+    readonly index: number;
+    readonly tool_id?: string | null;
+    readonly name?: string | null;
+    readonly arguments_delta?: string | null;
+    readonly done?: boolean;
+}
+/** A complete, immutable assistant output fragment, in response order.
+ * The loop can persist it and execute its calls while streaming continues.
+ * Adapters emitting fragments must cover the full terminal message, including
+ * opaque replay state. Partial arguments remain ToolCallDelta presentation only. */
+export interface OutputItemReady {
+    readonly _tag: "OutputItemReady";
+    readonly message: ProviderMessage;
+}
+export interface ProviderToolCallDelta {
+    readonly _tag: "ProviderToolCall";
+    readonly call: ProviderToolCall;
+}
+export interface ProviderStreamRetry {
+    readonly _tag: "ProviderStreamRetry";
+    /** 1-based transport attempt that just failed. */
+    readonly attempt: number;
+    /** Total attempts the provider will make before the failure stands. */
+    readonly maxAttempts: number;
+    /** Backoff the provider will sleep before re-streaming, in milliseconds. */
+    readonly delayMs?: number;
+}
+export interface ProviderMessage {
+    readonly role: "assistant";
+    readonly content: string | null;
+    readonly tool_calls: ReadonlyArray<ToolCall> | null;
+    readonly reasoning_content: string | null;
+    readonly provider_tool_calls?: ReadonlyArray<ProviderToolCall> | null;
+    /** Native output order normalized by the provider adapter. */
+    readonly output_parts?: ReadonlyArray<AssistantOutputPart> | null;
+    readonly provider_state?: ProviderState;
+}
+/** The terminal item of one provider response. */
+export interface CompletionResponse {
+    readonly _tag: "Completed";
+    /** A provider-owned successor is pending; this response is not a final answer. */
+    readonly continuation?: boolean;
+    readonly message: ProviderMessage;
+    readonly finish_reason: FinishReason | null;
+    readonly usage: Partial<Usage> & Pick<Usage, "completion_tokens">;
+    readonly model: string;
+}
+export type ModelStreamItem = TextContentDelta | ReasoningContentDelta | ToolCallStreamDelta | OutputItemReady | ProviderToolCallDelta | ProviderStreamRetry | CompletionResponse;
+export type ModelSource<A> = Iterable<A> | AsyncIterable<A> | PromiseLike<Iterable<A> | AsyncIterable<A>>;
+/** JSON-Schema response format for structured output, carried to the provider. */
+export interface ResponseFormat {
+    readonly name: string;
+    readonly schema: JsonSchema;
+}
+export interface ModelProviderRequest {
+    /** Invocation-scoped pending user input. Adapters may poll only while generating. */
+    readonly steering?: {
+        readonly take: () => Promise<ReadonlyArray<UserMessage>>;
+    };
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /**
+     * The loop's text for an interaction a provider carries natively (a user
+     * message that kept its `interaction`). Providers place it; they never word it.
+     */
+    readonly renderInteraction: (interaction: Interaction) => string;
+    readonly model: string;
+    readonly maxOutputTokens?: number;
+    readonly tools: ReadonlyArray<ToolDeclaration>;
+    /**
+     * The deferred catalog, loaded or not. It stays the same for a whole
+     * conversation; loaded tools reach the model inside the conversation.
+     */
+    readonly deferredTools: ReadonlyArray<ToolDeclaration>;
+    /** Present when the route searches on the client and the catalog is not empty. */
+    readonly toolSearch?: ToolSearch;
+    readonly toolChoice: ToolChoice;
+    readonly reasoningEffort?: string;
+    /** See `AgentConfigInput.cacheScope`; a provider without prompt caching ignores it. */
+    readonly cacheScope?: string;
+    readonly responseFormat?: ResponseFormat;
+    readonly signal?: AbortSignal;
+}
+export interface ModelProvider {
+    readonly protocolVersion: 1;
+    /** Allocate connection-local state for one agent invocation. */
+    readonly openSession?: () => MaybePromise<ModelProviderSession>;
+    /** Optional native features, resolved for the actual model/endpoint route. */
+    readonly capabilities?: (model: string) => MaybePromise<ModelCapabilities>;
+    readonly stream: (request: ModelProviderRequest) => ModelSource<ModelStreamItem>;
+}
+export interface ModelProviderSession {
+    readonly stream: ModelProvider["stream"];
+    readonly close: () => MaybePromise<void>;
+}
+export interface ModelCapabilities {
+    readonly agentMessages?: "native" | "message";
+    readonly asyncTools?: "native" | "message";
+    readonly steering?: "native" | "boundary";
+    readonly hostedTools: ReadonlyArray<string>;
+    /**
+     * `native` — the provider constrains the final text to `responseFormat`
+     * (the host supplies a schema its dialect accepts); `none` — the route
+     * cannot, and a run with `output` fails before inference.
+     */
+    readonly structuredOutput: "none" | "native";
+    /**
+     * `client` — the provider declares the request's `toolSearch` and answers
+     * the model's search calls with it, loading found tools into the
+     * conversation; `none` (the default) — the loop declares every tool.
+     */
+    readonly toolSearch?: "client" | "none";
+    /** The route's image input limits; absent, the host sends images as stored. */
+    readonly imageInput?: ImageInputLimits;
+}
+/** How a route measures and bounds an input image, in `patchSize`-pixel square patches. */
+export interface ImageInputLimits {
+    readonly patchSize: number;
+    /** Images are shrunk (aspect kept) to at most this longest side before sending. */
+    readonly fitSide: number;
+    /** ...and to at most this many patches. */
+    readonly fitPatches: number;
+    /** One image over this many patches fails the whole request. */
+    readonly maxPatches: number;
+}
+export interface ModelRequest {
+    readonly step: number;
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly model: string;
+    readonly maxOutputTokens?: number;
+    readonly tools: ReadonlyArray<ToolDeclaration>;
+    readonly deferredTools: ReadonlyArray<ToolDeclaration>;
+    readonly toolChoice: ToolChoice;
+    readonly reasoningEffort?: string;
+    /** See `AgentConfigInput.cacheScope`; a provider without prompt caching ignores it. */
+    readonly cacheScope?: string;
+    readonly responseFormat?: ResponseFormat;
+    readonly previousResponse: CompletionResponse | null;
+    /** The only middleware field allowed to persist a canonical history projection. */
+    readonly compactionReplacement?: ReadonlyArray<ChatMessage>;
+}
+export type ModelRequestNext = (request: ModelRequest) => MaybePromise<ModelRequest>;
+export type ModelRequestMiddleware = (request: ModelRequest, next: ModelRequestNext) => MaybePromise<ModelRequest>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/contracts/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/contracts/provider.ts"],"names":[],"mappings":"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"}

package/dist/contracts/provider.js

@@ -0,0 +1,26 @@
+export const ToolChoice = {
+    AUTO: "auto",
+    NONE: "none",
+    REQUIRED: "required"
+};
+export const FinishReason = {
+    STOP: "stop",
+    TOOL_CALLS: "tool_calls",
+    LENGTH: "length",
+    CONTENT_FILTER: "content_filter"
+};
+export const zeroUsage = () => ({
+    prompt_tokens: 0,
+    completion_tokens: 0,
+    cache_read_tokens: 0,
+    cache_write_tokens: 0
+});
+const count = (value) => value ?? 0;
+export const usageInputTokens = (usage) => count(usage.prompt_tokens) + count(usage.cache_read_tokens) + count(usage.cache_write_tokens);
+export const addUsage = (left, right) => ({
+    prompt_tokens: count(left.prompt_tokens) + count(right.prompt_tokens),
+    completion_tokens: count(left.completion_tokens) + count(right.completion_tokens),
+    cache_read_tokens: count(left.cache_read_tokens) + count(right.cache_read_tokens),
+    cache_write_tokens: count(left.cache_write_tokens) + count(right.cache_write_tokens)
+});
+//# sourceMappingURL=provider.js.map

package/dist/contracts/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/contracts/provider.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;CACZ,CAAA;AAIV,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,gBAAgB;CACxB,CAAA;AAWV,MAAM,CAAC,MAAM,SAAS,GAAG,GAAU,EAAE,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC;IAChB,iBAAiB,EAAE,CAAC;IACpB,iBAAiB,EAAE,CAAC;IACpB,kBAAkB,EAAE,CAAC;CACtB,CAAC,CAAA;AAEF,MAAM,KAAK,GAAG,CAAC,KAAyB,EAAU,EAAE,CAAC,KAAK,IAAI,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAqB,EAAU,EAAE,CAChE,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;AAE/F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAW,EAAE,KAAqB,EAAS,EAAE,CAAC,CAAC;IACtE,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC;IACrE,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACjF,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACjF,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC;CACrF,CAAC,CAAA"}