@vibefield/rosetta-protocol 0.0.0-stage → 0.1.0

package/dist/generated/StatusResponse.d.ts

@@ -0,0 +1,17 @@
+import type { DaemonStatus } from "./DaemonStatus.js";
+import type { SearchState } from "./SearchState.js";
+export type StatusResponse = {
+    protocol_version: number;
+    schema_version: number;
+    /**
+     * The open projection passed fail-closed schema admission; canonical
+     * queries are serveable.
+     */
+    canonical_ready: boolean;
+    search: SearchState;
+    /**
+     * Live-daemon health; `None` when the projection is served without an
+     * ingest loop (tests, static serving).
+     */
+    daemon: DaemonStatus | null;
+};

package/dist/generated/StatusResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/StreamState.d.ts

@@ -0,0 +1 @@
+export type StreamState = "pending" | "streaming" | "indexed";

package/dist/generated/StreamState.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/generated/SummaryPurpose.d.ts

@@ -0,0 +1 @@
+export type SummaryPurpose = "compaction" | "branch" | "handoff" | "session";

package/dist/generated/SummaryPurpose.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/generated/TaskOp.d.ts

@@ -0,0 +1 @@
+export type TaskOp = "create" | "update" | "list" | "get" | "stop" | "output";

package/dist/generated/TaskOp.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/generated/TaskSnapshot.d.ts

@@ -0,0 +1,9 @@
+import type { TaskSnapshotItem } from "./TaskSnapshotItem.js";
+/**
+ * A bounded task board immediately after the action completed. `total_count`
+ * stays honest if a native board exceeds the task-specific safety ceiling.
+ */
+export type TaskSnapshot = {
+    tasks: Array<TaskSnapshotItem>;
+    total_count: number;
+};

package/dist/generated/TaskSnapshot.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TaskSnapshotItem.d.ts

@@ -0,0 +1,13 @@
+import type { TaskStatus } from "./TaskStatus.js";
+/**
+ * One task in the bounded, point-in-time board attached to a task action.
+ * The raw ledger remains authoritative; this user-facing state makes both a
+ * compact preview and an explicit full-board disclosure possible.
+ */
+export type TaskSnapshotItem = {
+    task_id: string;
+    subject: string | null;
+    status: TaskStatus | null;
+    owner: string | null;
+    blocker_ids: Array<string>;
+};

package/dist/generated/TaskSnapshotItem.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TaskStatus.d.ts

@@ -0,0 +1 @@
+export type TaskStatus = "pending" | "in_progress" | "completed" | "failed" | "cancelled";

package/dist/generated/TaskStatus.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/generated/TextRange.d.ts

@@ -0,0 +1,4 @@
+export type TextRange = {
+    start: number;
+    end: number;
+};

package/dist/generated/TextRange.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/generated/TimelineBody.d.ts

@@ -0,0 +1,33 @@
+import type { AttachmentRef } from "./AttachmentRef.js";
+import type { CanonicalText } from "./CanonicalText.js";
+import type { CitationRef } from "./CitationRef.js";
+import type { CollaborationEvent } from "./CollaborationEvent.js";
+import type { Notice } from "./Notice.js";
+import type { SummaryPurpose } from "./SummaryPurpose.js";
+import type { ToolInteraction } from "./ToolInteraction.js";
+export type TimelineBody = {
+    "type": "user";
+    text: CanonicalText | null;
+    attachments: Array<AttachmentRef>;
+} | {
+    "type": "agent";
+    text: CanonicalText | null;
+    attachments: Array<AttachmentRef>;
+    citations: Array<CitationRef>;
+} | {
+    "type": "thinking";
+    text: CanonicalText;
+} | {
+    "type": "collaboration";
+    event: CollaborationEvent;
+} | {
+    "type": "tool_use";
+    tool: ToolInteraction;
+} | {
+    "type": "notice";
+    notice: Notice;
+} | {
+    "type": "summary";
+    purpose: SummaryPurpose;
+    text: CanonicalText;
+};

package/dist/generated/TimelineBody.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineEntry.d.ts

@@ -0,0 +1,37 @@
+import type { Provenance } from "./Provenance.js";
+import type { ResponseGroup } from "./ResponseGroup.js";
+import type { TimelineBody } from "./TimelineBody.js";
+import type { TimelineGroup } from "./TimelineGroup.js";
+import type { TokenSnapshot } from "./TokenSnapshot.js";
+import type { UsageCost } from "./UsageCost.js";
+export type TimelineEntry = {
+    timeline_id: string;
+    session_id: string;
+    ordinal: number;
+    group: TimelineGroup;
+    response: ResponseGroup | null;
+    block_index: number | null;
+    native_id: string | null;
+    parent_native_id: string | null;
+    at: number | null;
+    model: string | null;
+    effort: string | null;
+    body: TimelineBody;
+    /**
+     * Native tool invocation that owns a spawned child-session entry.
+     */
+    parent_tool_native_id: string | null;
+    /**
+     * Usage the row states for itself. An all-`None` snapshot makes no
+     * statement: the store keeps whatever a `Usage` op set on the row, so
+     * re-emitting a row never wipes its usage; only an all-`None` `Usage`
+     * op retracts it.
+     */
+    usage: TokenSnapshot;
+    /**
+     * Read-time cost of `usage`; absent when the row carries no usage or was
+     * not read for a transcript response or live mutation.
+     */
+    cost?: UsageCost;
+    provenance: Provenance;
+};

package/dist/generated/TimelineEntry.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineEntryResponse.d.ts

@@ -0,0 +1,5 @@
+import type { TimelineEntry } from "./TimelineEntry.js";
+export type TimelineEntryResponse = {
+    entry: TimelineEntry;
+    watermark: string;
+};

package/dist/generated/TimelineEntryResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineGroup.d.ts

@@ -0,0 +1,7 @@
+import type { GroupDerivation } from "./GroupDerivation.js";
+import type { GroupKind } from "./GroupKind.js";
+export type TimelineGroup = {
+    id: string;
+    kind: GroupKind;
+    derivation: GroupDerivation;
+};

package/dist/generated/TimelineGroup.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineMeta.d.ts

@@ -0,0 +1,10 @@
+import type { TimelineMetaArtifact } from "./TimelineMetaArtifact.js";
+import type { TimelineMetaPlan } from "./TimelineMetaPlan.js";
+import type { TimelineMetaTask } from "./TimelineMetaTask.js";
+import type { TimelineMetaWorkflow } from "./TimelineMetaWorkflow.js";
+export type TimelineMeta = {
+    tasks: Array<TimelineMetaTask>;
+    workflows: Array<TimelineMetaWorkflow>;
+    plans: Array<TimelineMetaPlan>;
+    artifacts: Array<TimelineMetaArtifact>;
+};

package/dist/generated/TimelineMeta.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineMetaArtifact.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactKind } from "./ArtifactKind.js";
+import type { TimelineMetaArtifactSource } from "./TimelineMetaArtifactSource.js";
+export type TimelineMetaArtifact = {
+    id: string;
+    name: string;
+    artifact_kind: ArtifactKind;
+    created_at: number | null;
+    byte_len: number | null;
+    media_type: string | null;
+    source: TimelineMetaArtifactSource;
+};

package/dist/generated/TimelineMetaArtifact.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineMetaArtifactSource.d.ts

@@ -0,0 +1,10 @@
+import type { AssetRef } from "./AssetRef.js";
+export type TimelineMetaArtifactSource = {
+    "type": "timeline_file";
+    timeline_id: string;
+    target_index: number;
+    path: string;
+} | {
+    "type": "asset";
+    asset: AssetRef;
+};

package/dist/generated/TimelineMetaArtifactSource.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineMetaPlan.d.ts

@@ -0,0 +1,8 @@
+import type { TimelineMetaPlanSource } from "./TimelineMetaPlanSource.js";
+export type TimelineMetaPlan = {
+    id: string;
+    name: string;
+    updated_at: number | null;
+    byte_len: number;
+    source: TimelineMetaPlanSource;
+};

package/dist/generated/TimelineMetaPlan.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineMetaPlanSource.d.ts

@@ -0,0 +1,7 @@
+export type TimelineMetaPlanSource = {
+    "type": "revision";
+    revision: number;
+} | {
+    "type": "timeline";
+    timeline_id: string;
+};

package/dist/generated/TimelineMetaPlanSource.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/generated/TimelineMetaTask.d.ts

@@ -0,0 +1,13 @@
+import type { TaskStatus } from "./TaskStatus.js";
+export type TimelineMetaTask = {
+    id: string;
+    subject: string;
+    status: TaskStatus | null;
+    started_at: number | null;
+    terminal_at: number | null;
+    /**
+     * Exact task-family row to land on. `None` is honest for native task
+     * tables that have no corresponding transcript act.
+     */
+    timeline_id: string | null;
+};

package/dist/generated/TimelineMetaTask.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelineMetaWorkflow.d.ts

@@ -0,0 +1,30 @@
+import type { WorkflowRunStatus } from "./WorkflowRunStatus.js";
+/**
+ * One canonical Workflow run. Attempts remain chronological transcript rows;
+ * this summary counts a resumed run once and points at its latest attempt.
+ */
+export type TimelineMetaWorkflow = {
+    id: string;
+    name: string;
+    status: WorkflowRunStatus;
+    started_at: number | null;
+    duration_ms: number | null;
+    /**
+     * Exact current roster length from the durable run document. A run id
+     * observed before its sidecar keeps this unknown instead of claiming 0.
+     */
+    worker_count: number | null;
+    /**
+     * Exact child-session references from the durable worker roster and its
+     * append-only journal. These are relation metadata, not copied child
+     * bodies; they let a client suppress the generic unanchored-child
+     * fallback even when the owning workflow message is outside its loaded
+     * transcript page or an earlier attempt is no longer in the live roster.
+     */
+    child_session_ids: Array<string>;
+    /**
+     * Latest Workflow attempt carrying this run id. `None` is honest for a
+     * sidecar that arrived before its transcript invocation.
+     */
+    timeline_id: string | null;
+};

package/dist/generated/TimelineMetaWorkflow.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TimelinePage.d.ts

@@ -0,0 +1,17 @@
+import type { TimelineEntry } from "./TimelineEntry.js";
+/**
+ * One backward page of a session timeline, oldest-first within the page.
+ */
+export type TimelinePage = {
+    entries: Array<TimelineEntry>;
+    /**
+     * Projection generation shared by the snapshot, pages, and exact reads.
+     */
+    watermark: string;
+    /**
+     * Opaque continuation for the next older page; `None` at the top of
+     * the timeline. Expires (HTTP 410, [`ErrorCode::CursorExpired`]) when
+     * the session's projection was rewritten under it.
+     */
+    cursor: string | null;
+};

package/dist/generated/TimelinePage.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/TokenSnapshot.d.ts

@@ -0,0 +1,61 @@
+import type { ServiceTier } from "./ServiceTier.js";
+import type { UsageScope } from "./UsageScope.js";
+/**
+ * One model request's usage (ARCHITECTURE §4.1.3). The six token buckets
+ * are mutually exclusive — every token is in exactly one — so any sum of
+ * them is a true total. Every component is `Option`: `None` means the agent
+ * never reported it, which must never be coerced to zero.
+ */
+export type TokenSnapshot = {
+    /**
+     * Prompt tokens neither read from nor written to a cache.
+     */
+    input: number | null;
+    /**
+     * Generated tokens, excluding reasoning.
+     */
+    output: number | null;
+    /**
+     * Prompt tokens served from a cache.
+     */
+    cache_read: number | null;
+    /**
+     * Prompt tokens written at the provider's default (≤ 5-minute) TTL.
+     */
+    cache_write: number | null;
+    /**
+     * Reasoning/thinking tokens; never also counted in `output`.
+     */
+    thinking: number | null;
+    /**
+     * Prompt tokens written to a 1-hour cache.
+     */
+    cache_write_1h: number | null;
+    /**
+     * Server-side web search requests the provider bills per call.
+     */
+    web_searches: number | null;
+    service_tier: ServiceTier | null;
+    /**
+     * Serving provider when the record names one that differs from the
+     * agent's default; a [`canonical_route`] slug.
+     */
+    route: string | null;
+    /**
+     * The provider's own billed amount for this request in pico-USD
+     * (10⁻¹² USD). Never an agent-computed estimate.
+     */
+    billed_pico_usd: number | null;
+    /**
+     * One model request, or a total the agent reports over several (a Grok
+     * turn, a Copilot shutdown interval, a Hermes session row). Pricing
+     * needs it: a long-context tier can only be decided per request.
+     */
+    scope: UsageScope;
+    /**
+     * How many model requests an aggregate sums, when the agent reports it.
+     * Pricing estimates the aggregate as that many equal requests, so a
+     * long-context tier follows the average request. `None` on one request.
+     */
+    requests: number | null;
+};

package/dist/generated/TokenSnapshot.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/ToolAction.d.ts

@@ -0,0 +1,245 @@
+import type { ArtifactKind } from "./ArtifactKind.js";
+import type { ArtifactOp } from "./ArtifactOp.js";
+import type { CanonicalDocument } from "./CanonicalDocument.js";
+import type { CanonicalText } from "./CanonicalText.js";
+import type { ChildTrace } from "./ChildTrace.js";
+import type { CodeLookupOp } from "./CodeLookupOp.js";
+import type { CollaborationOp } from "./CollaborationOp.js";
+import type { CollaborationOutcome } from "./CollaborationOutcome.js";
+import type { DisplayField } from "./DisplayField.js";
+import type { ExecutionMode } from "./ExecutionMode.js";
+import type { FetchOutcome } from "./FetchOutcome.js";
+import type { FileDelta } from "./FileDelta.js";
+import type { FileSearchMode } from "./FileSearchMode.js";
+import type { FindingItem } from "./FindingItem.js";
+import type { ListOutcome } from "./ListOutcome.js";
+import type { LocationOutcome } from "./LocationOutcome.js";
+import type { MediaMetadata } from "./MediaMetadata.js";
+import type { ModeOp } from "./ModeOp.js";
+import type { ParticipantColor } from "./ParticipantColor.js";
+import type { PlanOp } from "./PlanOp.js";
+import type { ProcessOp } from "./ProcessOp.js";
+import type { ProcessOutcome } from "./ProcessOutcome.js";
+import type { ReadOutcome } from "./ReadOutcome.js";
+import type { ReadTarget } from "./ReadTarget.js";
+import type { ResourceRef } from "./ResourceRef.js";
+import type { ScheduleOp } from "./ScheduleOp.js";
+import type { SearchFilter } from "./SearchFilter.js";
+import type { SearchOutcome } from "./SearchOutcome.js";
+import type { ShellOutcome } from "./ShellOutcome.js";
+import type { TaskOp } from "./TaskOp.js";
+import type { TaskSnapshot } from "./TaskSnapshot.js";
+import type { TaskStatus } from "./TaskStatus.js";
+import type { UserAnswer } from "./UserAnswer.js";
+import type { UserQuestion } from "./UserQuestion.js";
+import type { WebNavigationOp } from "./WebNavigationOp.js";
+import type { WebSearchOutcome } from "./WebSearchOutcome.js";
+import type { WorkflowRun } from "./WorkflowRun.js";
+import type { WorkflowUsage } from "./WorkflowUsage.js";
+export type ToolAction = {
+    "type": "file_read";
+    targets: Array<ReadTarget>;
+    outcome: ReadOutcome | null;
+} | {
+    "type": "file_list";
+    directory: ResourceRef;
+    depth: number | null;
+    filter: string | null;
+    outcome: ListOutcome | null;
+} | {
+    "type": "file_search";
+    query: string;
+    mode: FileSearchMode;
+    roots: Array<ResourceRef>;
+    filters: Array<SearchFilter>;
+    outcome: SearchOutcome | null;
+} | {
+    "type": "code_lookup";
+    operation: CodeLookupOp;
+    query: string;
+    path: ResourceRef | null;
+    outcome: LocationOutcome | null;
+} | {
+    "type": "file_change";
+    changes: Array<FileDelta>;
+} | {
+    "type": "shell";
+    command: CanonicalText;
+    /**
+     * The command is a bounded projection preview. Its exact source text
+     * remains addressable through the row's raw-ledger provenance.
+     */
+    source_truncated?: boolean;
+    cwd: ResourceRef | null;
+    timeout_ms: number | null;
+    background: boolean;
+    outcome: ShellOutcome | null;
+} | {
+    "type": "code_execute";
+    language: string | null;
+    code: CanonicalText;
+    /**
+     * The code is a bounded projection preview. Its exact source text
+     * remains addressable through the row's raw-ledger provenance.
+     */
+    source_truncated?: boolean;
+    cwd: ResourceRef | null;
+    outcome: ShellOutcome | null;
+} | {
+    "type": "process";
+    operation: ProcessOp;
+    process_id: string;
+    input: CanonicalText | null;
+    outcome: ProcessOutcome | null;
+} | {
+    "type": "orchestration";
+    runtime: string | null;
+    trace: ChildTrace;
+    executed_children: Array<string>;
+    executed_child_count: number | null;
+} | {
+    "type": "web_search";
+    query: string | null;
+    allowed_domains: Array<string>;
+    blocked_domains: Array<string>;
+    outcome: WebSearchOutcome | null;
+} | {
+    "type": "web_navigate";
+    operation: WebNavigationOp;
+    url: ResourceRef | null;
+    pattern: string | null;
+    outcome: FetchOutcome | null;
+} | {
+    "type": "web_fetch";
+    url: ResourceRef;
+    purpose: string | null;
+    outcome: FetchOutcome | null;
+} | {
+    "type": "delegate";
+    agent_kind: string | null;
+    name: string | null;
+    model: string | null;
+    mode: string | null;
+    /**
+     * Present only when native evidence proves this invocation addresses
+     * a persistent team rather than an invocation-owned worker.
+     */
+    team: string | null;
+    /**
+     * Native participant address colour.  Absence stays absence.
+     */
+    color: ParticipantColor | null;
+    objective: CanonicalText;
+    child_session_id: string | null;
+    resume_id: string | null;
+    background: boolean;
+    orphan_result_summary: CanonicalText | null;
+} | {
+    "type": "task";
+    operation: TaskOp;
+    task_id: string | null;
+    subject: string | null;
+    description: CanonicalText | null;
+    status: TaskStatus | null;
+    owner: string | null;
+    blocker_ids: Array<string>;
+    snapshot: TaskSnapshot | null;
+} | {
+    "type": "plan";
+    operation: PlanOp;
+    plan_id: string | null;
+    title: string | null;
+    summary: CanonicalText | null;
+    step_count: number | null;
+} | {
+    "type": "collaborate";
+    operation: CollaborationOp;
+    recipient: string | null;
+    team: string | null;
+    summary: string | null;
+    body: CanonicalText | null;
+    linked_session_id: string | null;
+    delivery_id: string | null;
+    outcome: CollaborationOutcome | null;
+} | {
+    "type": "question";
+    questions: Array<UserQuestion>;
+    answers: Array<UserAnswer>;
+} | {
+    "type": "skill";
+    name: string;
+    arguments: CanonicalText | null;
+} | {
+    "type": "workflow";
+    name: string | null;
+    path: ResourceRef | null;
+    arguments: CanonicalText | null;
+    objective: CanonicalText | null;
+    resume_id: string | null;
+    background: boolean;
+    task_id: string | null;
+    run_id: string | null;
+    attempt: number | null;
+    callback_summary: string | null;
+    /**
+     * Structured callback result retained as canonical JSON/text when a
+     * run sidecar is delayed or absent. The hydrated run remains the
+     * authoritative current snapshot when both exist.
+     */
+    callback_result: CanonicalText | null;
+    usage: WorkflowUsage | null;
+    /**
+     * Hydrated from the generation-owned workflow sidecar at read time;
+     * the stored tool row keeps this `None`, so every attempt points to
+     * one run document instead of copying it.
+     */
+    run: WorkflowRun | null;
+} | {
+    "type": "schedule";
+    operation: ScheduleOp;
+    schedule_id: string | null;
+    due_at: number | null;
+    delay_ms: number | null;
+    reason: string | null;
+    objective: CanonicalText | null;
+} | {
+    "type": "artifact";
+    operation: ArtifactOp;
+    artifact_kind: ArtifactKind;
+    name: string | null;
+    description: CanonicalText | null;
+    resources: Array<ResourceRef>;
+    media: MediaMetadata | null;
+} | {
+    "type": "tool_discovery";
+    query: string;
+    matches: Array<string>;
+    total_count: number;
+} | {
+    "type": "mode";
+    operation: ModeOp;
+    mode: ExecutionMode;
+    workspace: ResourceRef | null;
+} | {
+    "type": "finding";
+    findings: Array<FindingItem>;
+    total_count: number;
+} | {
+    "type": "notification";
+    channel: string | null;
+    destination: string | null;
+    summary: CanonicalText;
+    delivery_id: string | null;
+} | {
+    "type": "structured_output";
+    document: CanonicalDocument;
+} | {
+    "type": "external";
+    provider: string | null;
+    operation: string;
+    subject: string | null;
+    fields: Array<DisplayField>;
+    resources: Array<ResourceRef>;
+} | {
+    "type": "unknown";
+};

package/dist/generated/ToolAction.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/ToolCorrelation.d.ts

@@ -0,0 +1,5 @@
+import type { CorrelationDerivation } from "./CorrelationDerivation.js";
+export type ToolCorrelation = {
+    key: string;
+    derivation: CorrelationDerivation;
+};