veryfront 0.1.810 → 0.1.812

package/esm/deno.d.ts

@@ -31,6 +31,7 @@ declare namespace _default {
         "./workflow/claude-code": string;
         "./workflow/claude-code/react": string;
         "./workflow/discovery": string;
+        "./work": string;
         "./schemas": string;
         "./prompt": string;
         "./resource": string;
@@ -100,6 +101,7 @@ declare namespace _default {
         "veryfront/workflow/claude-code": string;
         "veryfront/workflow/claude-code/react": string;
         "veryfront/workflow/discovery": string;
+        "veryfront/work": string;
         "veryfront/utils": string;
         "veryfront/utils/box": string;
         "veryfront/utils/case-utils": string;
@@ -203,6 +205,7 @@ declare namespace _default {
         "#veryfront/workflow/claude-code": string;
         "#veryfront/workflow/claude-code/react": string;
         "#veryfront/workflow/discovery": string;
+        "#veryfront/work": string;
         "#veryfront/schemas": string;
         "#veryfront/http/responses": string;
         "#veryfront/compat/console": string;

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.810",
+    "version": "0.1.812",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {
@@ -86,6 +86,7 @@ export default {
         "./workflow/claude-code": "./src/workflow/claude-code/index.ts",
         "./workflow/claude-code/react": "./src/workflow/claude-code/react/index.ts",
         "./workflow/discovery": "./src/workflow/discovery/index.ts",
+        "./work": "./src/work/index.ts",
         "./schemas": "./src/schemas/index.ts",
         "./prompt": "./src/prompt/index.ts",
         "./resource": "./src/resource/index.ts",
@@ -155,6 +156,7 @@ export default {
         "veryfront/workflow/claude-code": "./src/workflow/claude-code/index.ts",
         "veryfront/workflow/claude-code/react": "./src/workflow/claude-code/react/index.ts",
         "veryfront/workflow/discovery": "./src/workflow/discovery/index.ts",
+        "veryfront/work": "./src/work/index.ts",
         "veryfront/utils": "./src/utils/index.ts",
         "veryfront/utils/box": "./src/utils/box.ts",
         "veryfront/utils/case-utils": "./src/utils/case-utils.ts",
@@ -258,6 +260,7 @@ export default {
         "#veryfront/workflow/claude-code": "./src/workflow/claude-code/index.ts",
         "#veryfront/workflow/claude-code/react": "./src/workflow/claude-code/react/index.ts",
         "#veryfront/workflow/discovery": "./src/workflow/discovery/index.ts",
+        "#veryfront/work": "./src/work/index.ts",
         "#veryfront/schemas": "./src/schemas/index.ts",
         "#veryfront/http/responses": "./src/platform/compat/http/responses.ts",
         "#veryfront/compat/console": "./src/platform/compat/console/index.ts",
@@ -368,7 +371,7 @@ export default {
         "lint": "DENO_NO_PACKAGE_JSON=1 deno lint src/ cli/ react/ && deno lint --config=scripts/test.deno.json scripts/test/ scripts/build/npm-package-metadata.test.ts",
         "fmt": "deno fmt src/ cli/ react/ && deno fmt --config=scripts/test.deno.json scripts/test/",
         "fmt:check": "deno fmt --check src/ cli/ react/ && deno fmt --check --config=scripts/test.deno.json scripts/test/",
-        "typecheck": "deno task generate:manifests:check && deno check src/index.ts cli/main.ts src/server/index.ts src/routing/api/index.ts src/rendering/index.ts src/platform/index.ts src/platform/adapters/index.ts src/build/index.ts src/build/production-build/index.ts src/transforms/index.ts src/config/index.ts src/utils/index.ts src/data/index.ts src/security/index.ts src/middleware/index.ts src/server/handlers/dev/index.ts src/server/handlers/request/api/index.ts src/rendering/cache/index.ts src/rendering/cache/stores/index.ts src/rendering/rsc/actions/index.ts src/html/index.ts src/modules/index.ts src/proxy/main.ts src/chat/index.ts src/markdown/index.ts src/mdx/index.ts src/fs/index.ts src/oauth/index.ts src/agent/index.ts src/agent/service/route-export.check.ts src/tool/index.ts src/workflow/index.ts src/prompt/index.ts src/resource/index.ts src/runs/index.ts src/mcp/index.ts src/provider/index.ts",
+        "typecheck": "deno task generate:manifests:check && deno check src/index.ts cli/main.ts src/server/index.ts src/routing/api/index.ts src/rendering/index.ts src/platform/index.ts src/platform/adapters/index.ts src/build/index.ts src/build/production-build/index.ts src/transforms/index.ts src/config/index.ts src/utils/index.ts src/data/index.ts src/security/index.ts src/middleware/index.ts src/server/handlers/dev/index.ts src/server/handlers/request/api/index.ts src/rendering/cache/index.ts src/rendering/cache/stores/index.ts src/rendering/rsc/actions/index.ts src/html/index.ts src/modules/index.ts src/proxy/main.ts src/chat/index.ts src/markdown/index.ts src/mdx/index.ts src/fs/index.ts src/oauth/index.ts src/agent/index.ts src/agent/service/route-export.check.ts src/tool/index.ts src/workflow/index.ts src/work/index.ts src/prompt/index.ts src/resource/index.ts src/runs/index.ts src/mcp/index.ts src/provider/index.ts",
         "verify": "deno task generate:manifests:check && deno task fmt:check && deno task lint && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-test-only && deno task lint:sanitizer-baseline && deno task lint:skipped-tests && deno task lint:ban-zod && deno task lint:core-deps && deno task lint:dependency-boundaries && deno task lint:extension-contracts && deno task lint:extension-capabilities && deno task docs:validate && deno task typecheck && deno task test && deno task test:e2e:binary",
         "verify:quick": "deno task generate:manifests:check && deno task fmt:check && deno task lint && deno task lint:style && deno task lint:cli-boundary && deno task lint:wildcard-exports && deno task lint:barrel-jsdoc && deno task lint:ban-test-only && deno task lint:sanitizer-baseline && deno task lint:skipped-tests && deno task lint:ban-zod && deno task lint:core-deps && deno task lint:dependency-boundaries && deno task lint:extension-contracts && deno task lint:extension-capabilities && deno task docs:validate && deno task typecheck",
         "docs": "deno run --allow-read --allow-write --allow-run --allow-env scripts/docs/generate-api-reference.ts",

package/esm/src/agent/conversation/durable-contracts.d.ts

@@ -0,0 +1,204 @@
+import type { InferSchema } from "../../extensions/schema/index.js";
+/** Zod schema for get conversation run targets. */
+export declare const getConversationRunTargetsSchema: () => import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
+    sourceTargetKind: import("../../internal-agents/schema.js").Schema<string | null>;
+    runtimeTargetKind: import("../../internal-agents/schema.js").Schema<string | null>;
+    targetBranchId: import("../../internal-agents/schema.js").Schema<string | null>;
+}>>;
+/** Schema for conversation run targets.
+ * @deprecated Use getConversationRunTargetsSchema()
+ */
+export declare const ConversationRunTargetsSchema: import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
+    sourceTargetKind: import("../../internal-agents/schema.js").Schema<string | null>;
+    runtimeTargetKind: import("../../internal-agents/schema.js").Schema<string | null>;
+    targetBranchId: import("../../internal-agents/schema.js").Schema<string | null>;
+}>>;
+/** Public API contract for conversation run targets. */
+export type ConversationRunTargets = InferSchema<ReturnType<typeof getConversationRunTargetsSchema>>;
+/** Resolves conversation run targets. */
+export declare function resolveConversationRunTargets(input: {
+    projectId?: string | null;
+    branchId?: string | null;
+}): ConversationRunTargets;
+/** Zod schema for get conversation run status. */
+export declare const getConversationRunStatusSchema: () => import("../../internal-agents/schema.js").Schema<string>;
+/** Schema for conversation run status.
+ * @deprecated Use getConversationRunStatusSchema()
+ */
+export declare const ConversationRunStatusSchema: import("../../internal-agents/schema.js").Schema<string>;
+/** Public API contract for conversation run projection. */
+export interface ConversationRunProjection {
+    runId: string;
+    conversationId: string;
+    messageId: string;
+    latestEventId: number;
+    latestExternalEventSequence: number;
+    waitingToolCallId: string | null;
+    waitingToolName: string | null;
+    status: "pending" | "running" | "waiting_for_tool" | "completed" | "failed" | "cancelled";
+}
+/** Zod schema for get conversation run projection. */
+export declare const getConversationRunProjectionSchema: () => import("../../internal-agents/schema.js").Schema<ConversationRunProjection>;
+/** Schema for conversation run projection.
+ * @deprecated Use getConversationRunProjectionSchema()
+ */
+export declare const ConversationRunProjectionSchema: import("../../internal-agents/schema.js").Schema<ConversationRunProjection>;
+/** Public API contract for a conversation run status is active. */
+export type ActiveConversationRunStatus = Extract<ConversationRunProjection["status"], "pending" | "running" | "waiting_for_tool">;
+/** Public API contract for terminal conversation run status. */
+export type TerminalConversationRunStatus = Extract<ConversationRunProjection["status"], "completed" | "failed" | "cancelled">;
+/** Result returned from conversation run append cursor resync. */
+export type ConversationRunAppendCursorResyncResult = "advanced" | "non_appendable" | "unchanged";
+/** Public API contract for conversation run append recovery outcome. */
+export type ConversationRunAppendRecoveryOutcome = "resumed" | "stopped" | "bubbled";
+/** Public API contract for conversation run append failure outcome. */
+export type ConversationRunAppendFailureOutcome = "resumed" | "stopped" | "retry_scheduled";
+/** Public API contract for conversation run append execution outcome. */
+export type ConversationRunAppendExecutionOutcome = "resumed" | "stopped" | "retry_scheduled";
+/** Public API contract for conversation run batch flush outcome. */
+export type ConversationRunBatchFlushOutcome = "flushed" | "resumed" | "stopped" | "retry_scheduled";
+/** Public API contract for conversation run queue flush outcome. */
+export type ConversationRunQueueFlushOutcome = "flushed" | "stopped" | "retry_scheduled";
+/** Public API contract for conversation run event queue controller. */
+export interface ConversationRunEventQueueController {
+    enqueue(events: unknown[]): void;
+    flush(): Promise<{
+        outcome: "idle" | "flushed";
+        latestEventId: number;
+        latestExternalEventSequence: number;
+        pendingEventCount: number;
+        consecutiveFailures: number;
+        disabled: boolean;
+    } | {
+        outcome: "stopped";
+        latestEventId: number;
+        latestExternalEventSequence: number;
+        pendingEventCount: 0;
+        consecutiveFailures: number;
+        disabled: true;
+        disableReason?: "cursor_resyncs_exhausted" | "non_appendable" | "ignorable_append_rejection";
+    } | {
+        outcome: "retry_scheduled";
+        latestEventId: number;
+        latestExternalEventSequence: number;
+        pendingEventCount: number;
+        consecutiveFailures: number;
+        disabled: false;
+        errorMessage: string;
+    }>;
+    getSnapshot(): {
+        latestEventId: number;
+        latestExternalEventSequence: number;
+        pendingEventCount: number;
+        consecutiveFailures: number;
+        disabled: boolean;
+    };
+}
+/** Zod schema for get create conversation run accepted. */
+export declare const getCreateConversationRunAcceptedSchema: () => import("../../internal-agents/schema.js").Schema<{
+    runId: string;
+}>;
+/** Schema for create conversation run accepted.
+ * @deprecated Use getCreateConversationRunAcceptedSchema()
+ */
+export declare const CreateConversationRunAcceptedSchema: import("../../internal-agents/schema.js").Schema<{
+    runId: string;
+}>;
+/** Zod schema for get complete conversation run response. */
+export declare const getCompleteConversationRunResponseSchema: () => import("../../internal-agents/schema.js").Schema<{
+    completed: boolean;
+    run: {
+        status: string;
+    } & {
+        runId?: string | undefined;
+        run_id?: string | undefined;
+    } & Record<string, unknown>;
+} & {} & Record<string, unknown>>;
+/** Schema for complete conversation run response.
+ * @deprecated Use getCompleteConversationRunResponseSchema()
+ */
+export declare const CompleteConversationRunResponseSchema: import("../../internal-agents/schema.js").Schema<{
+    completed: boolean;
+    run: {
+        status: string;
+    } & {
+        runId?: string | undefined;
+        run_id?: string | undefined;
+    } & Record<string, unknown>;
+} & {} & Record<string, unknown>>;
+/** Response payload for append conversation run events. */
+export interface AppendConversationRunEventsResponse {
+    latestEventId: number;
+    latestExternalEventSequence: number;
+    appendedCount: number;
+    run: {
+        runId: string;
+        conversationId: string;
+        latestEventId: number;
+        latestExternalEventSequence: number;
+        [key: string]: unknown;
+    };
+}
+/** Zod schema for get append conversation run events response. */
+export declare const getAppendConversationRunEventsResponseSchema: () => import("../../internal-agents/schema.js").Schema<AppendConversationRunEventsResponse | import("../../extensions/schema/schema-validator.js").InferShape<{
+    latestEventId: import("../../internal-agents/schema.js").Schema<number>;
+    latestExternalEventSequence: import("../../internal-agents/schema.js").Schema<number>;
+    appendedCount: import("../../internal-agents/schema.js").Schema<number>;
+    run: import("../../internal-agents/schema.js").Schema<{
+        runId: string;
+        conversationId: string;
+        latestEventId: number;
+        latestExternalEventSequence: number;
+    } & {} & Record<string, unknown>>;
+}>>;
+/** Schema for append conversation run events response.
+ * @deprecated Use getAppendConversationRunEventsResponseSchema()
+ */
+export declare const AppendConversationRunEventsResponseSchema: import("../../internal-agents/schema.js").Schema<AppendConversationRunEventsResponse | import("../../extensions/schema/schema-validator.js").InferShape<{
+    latestEventId: import("../../internal-agents/schema.js").Schema<number>;
+    latestExternalEventSequence: import("../../internal-agents/schema.js").Schema<number>;
+    appendedCount: import("../../internal-agents/schema.js").Schema<number>;
+    run: import("../../internal-agents/schema.js").Schema<{
+        runId: string;
+        conversationId: string;
+        latestEventId: number;
+        latestExternalEventSequence: number;
+    } & {} & Record<string, unknown>>;
+}>>;
+/** Zod schema for get conversation run error. */
+export declare const getConversationRunErrorSchema: () => import("../../internal-agents/schema.js").Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
+    detail: import("../../internal-agents/schema.js").Schema<string | undefined>;
+    error: import("../../internal-agents/schema.js").Schema<string | undefined>;
+}>>;
+/** Public API contract for conversation agent run usage. */
+export interface ConversationAgentRunUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/** Input payload for create conversation agent run. */
+export interface CreateConversationAgentRunInput {
+    authToken: string;
+    apiUrl: string;
+    conversationId: string;
+    runId?: string;
+    parentRunId?: string;
+    agentId: string;
+    implementationKind?: string | null;
+    projectId?: string | null;
+    branchId?: string | null;
+}
+/** Input payload for finalize conversation agent run. */
+export interface FinalizeConversationAgentRunInput {
+    authToken: string;
+    apiUrl: string;
+    conversationId: string;
+    runId: string;
+    status: "completed" | "failed" | "cancelled";
+    model: string;
+    provider: string;
+    usage?: ConversationAgentRunUsage;
+    terminalErrorCode?: string | null;
+    terminalErrorMessage?: string | null;
+}
+//# sourceMappingURL=durable-contracts.d.ts.map

package/esm/src/agent/conversation/durable-contracts.d.ts.map

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

package/esm/src/agent/conversation/durable-contracts.js

@@ -0,0 +1,168 @@
+import { defineSchema, lazySchema } from "../../schemas/index.js";
+/** Zod schema for get conversation run targets. */
+export const getConversationRunTargetsSchema = defineSchema((v) => v.object({
+    sourceTargetKind: v.enum(["project", "preview_branch"]).nullable(),
+    runtimeTargetKind: v.enum(["main_branch", "preview_branch"]).nullable(),
+    targetBranchId: v.string().uuid().nullable(),
+}));
+/** Schema for conversation run targets.
+ * @deprecated Use getConversationRunTargetsSchema()
+ */
+export const ConversationRunTargetsSchema = lazySchema(getConversationRunTargetsSchema);
+/** Resolves conversation run targets. */
+export function resolveConversationRunTargets(input) {
+    return getConversationRunTargetsSchema().parse(!input.projectId
+        ? {
+            sourceTargetKind: null,
+            runtimeTargetKind: null,
+            targetBranchId: null,
+        }
+        : input.branchId
+            ? {
+                sourceTargetKind: "preview_branch",
+                runtimeTargetKind: "preview_branch",
+                targetBranchId: input.branchId,
+            }
+            : {
+                sourceTargetKind: "project",
+                runtimeTargetKind: "main_branch",
+                targetBranchId: null,
+            });
+}
+/** Zod schema for get conversation run status. */
+export const getConversationRunStatusSchema = defineSchema((v) => v.enum(["pending", "running", "waiting_for_tool", "completed", "failed", "cancelled"]));
+/** Schema for conversation run status.
+ * @deprecated Use getConversationRunStatusSchema()
+ */
+export const ConversationRunStatusSchema = lazySchema(getConversationRunStatusSchema);
+/** Zod schema for get conversation run projection. */
+export const getConversationRunProjectionSchema = defineSchema((v) => v.object({
+    runId: v.string().min(1).optional(),
+    run_id: v.string().min(1).optional(),
+    conversationId: v.string().uuid().optional(),
+    conversation_id: v.string().uuid().optional(),
+    messageId: v.string().uuid().optional(),
+    message_id: v.string().uuid().optional(),
+    latestEventId: v.number().int().nonnegative().optional(),
+    latest_event_id: v.number().int().nonnegative().optional(),
+    latestExternalEventSequence: v.number().int().nonnegative().optional(),
+    latest_external_event_sequence: v.number().int().nonnegative().optional(),
+    waitingToolCallId: v.string().min(1).nullable().optional(),
+    waiting_tool_call_id: v.string().min(1).nullable().optional(),
+    waitingToolName: v.string().nullable().optional(),
+    waiting_tool_name: v.string().nullable().optional(),
+    status: getConversationRunStatusSchema(),
+})
+    .passthrough()
+    .transform((data) => {
+    const d = data;
+    const runId = (d.runId ?? d.run_id);
+    const conversationId = (d.conversationId ?? d.conversation_id);
+    const messageId = (d.messageId ?? d.message_id);
+    const latestEventId = (d.latestEventId ?? d.latest_event_id) ?? 0;
+    const latestExternalEventSequence = (d.latestExternalEventSequence ??
+        d.latest_external_event_sequence);
+    if (!runId || !conversationId || !messageId) {
+        throw new Error("Missing run identifiers in durable run response");
+    }
+    if (latestExternalEventSequence === undefined) {
+        throw new Error("Missing latestExternalEventSequence in durable run response");
+    }
+    return {
+        runId,
+        conversationId,
+        messageId,
+        latestEventId,
+        latestExternalEventSequence,
+        waitingToolCallId: (d.waitingToolCallId ?? d.waiting_tool_call_id) ??
+            null,
+        waitingToolName: (d.waitingToolName ?? d.waiting_tool_name) ?? null,
+        status: d.status,
+    };
+}));
+/** Schema for conversation run projection.
+ * @deprecated Use getConversationRunProjectionSchema()
+ */
+export const ConversationRunProjectionSchema = lazySchema(getConversationRunProjectionSchema);
+/** Zod schema for get create conversation run accepted. */
+export const getCreateConversationRunAcceptedSchema = defineSchema((v) => v.object({
+    run: v.object({
+        runId: v.string().min(1).optional(),
+        run_id: v.string().min(1).optional(),
+    }).passthrough(),
+})
+    .passthrough()
+    .transform((data) => {
+    const d = data;
+    const runId = (d.run.runId ?? d.run.run_id);
+    if (!runId) {
+        throw new Error("Missing run id in canonical create run response");
+    }
+    return { runId };
+}));
+/** Schema for create conversation run accepted.
+ * @deprecated Use getCreateConversationRunAcceptedSchema()
+ */
+export const CreateConversationRunAcceptedSchema = lazySchema(getCreateConversationRunAcceptedSchema);
+/** Zod schema for get complete conversation run response. */
+export const getCompleteConversationRunResponseSchema = defineSchema((v) => v.object({
+    completed: v.boolean(),
+    run: v.object({
+        runId: v.string().min(1).optional(),
+        run_id: v.string().min(1).optional(),
+        status: v.enum(["pending", "running", "waiting", "completed", "failed", "cancelled"]),
+    }).passthrough(),
+}).passthrough());
+/** Schema for complete conversation run response.
+ * @deprecated Use getCompleteConversationRunResponseSchema()
+ */
+export const CompleteConversationRunResponseSchema = lazySchema(getCompleteConversationRunResponseSchema);
+/** Zod schema for get append conversation run events response. */
+export const getAppendConversationRunEventsResponseSchema = defineSchema((v) => v.union([
+    v.object({
+        latestEventId: v.number().int().nonnegative(),
+        latestExternalEventSequence: v.number().int().nonnegative(),
+        appendedCount: v.number().int().nonnegative(),
+        run: v.object({
+            runId: v.string().min(1),
+            conversationId: v.string().uuid(),
+            latestEventId: v.number().int().nonnegative(),
+            latestExternalEventSequence: v.number().int().nonnegative(),
+        }).passthrough(),
+    }),
+    v.object({
+        latest_event_id: v.number().int().nonnegative(),
+        latest_external_event_sequence: v.number().int().nonnegative(),
+        appended_count: v.number().int().nonnegative(),
+        run: v.object({
+            run_id: v.string().min(1),
+            conversation_id: v.string().uuid(),
+            latest_event_id: v.number().int().nonnegative(),
+            latest_external_event_sequence: v.number().int().nonnegative(),
+        }).passthrough(),
+    }).transform((data) => {
+        const d = data;
+        const run = d.run;
+        return {
+            latestEventId: d.latest_event_id,
+            latestExternalEventSequence: d.latest_external_event_sequence,
+            appendedCount: d.appended_count,
+            run: {
+                ...run,
+                runId: run.run_id,
+                conversationId: run.conversation_id,
+                latestEventId: run.latest_event_id,
+                latestExternalEventSequence: run.latest_external_event_sequence,
+            },
+        };
+    }),
+]));
+/** Schema for append conversation run events response.
+ * @deprecated Use getAppendConversationRunEventsResponseSchema()
+ */
+export const AppendConversationRunEventsResponseSchema = lazySchema(getAppendConversationRunEventsResponseSchema);
+/** Zod schema for get conversation run error. */
+export const getConversationRunErrorSchema = defineSchema((v) => v.object({
+    detail: v.string().min(1).optional(),
+    error: v.string().min(1).optional(),
+}));

package/esm/src/agent/conversation/durable.d.ts

@@ -1,201 +1,6 @@
-import type { InferSchema, Schema } from "../../extensions/schema/index.js";
-/** Zod schema for get conversation run targets. */
-export declare const getConversationRunTargetsSchema: () => Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
-    sourceTargetKind: Schema<string | null>;
-    runtimeTargetKind: Schema<string | null>;
-    targetBranchId: Schema<string | null>;
-}>>;
-/** Schema for conversation run targets.
- * @deprecated Use getConversationRunTargetsSchema()
- */
-export declare const ConversationRunTargetsSchema: Schema<import("../../extensions/schema/schema-validator.js").InferShape<{
-    sourceTargetKind: Schema<string | null>;
-    runtimeTargetKind: Schema<string | null>;
-    targetBranchId: Schema<string | null>;
-}>>;
-/** Public API contract for conversation run targets. */
-export type ConversationRunTargets = InferSchema<ReturnType<typeof getConversationRunTargetsSchema>>;
-/** Resolves conversation run targets. */
-export declare function resolveConversationRunTargets(input: {
-    projectId?: string | null;
-    branchId?: string | null;
-}): ConversationRunTargets;
-/** Zod schema for get conversation run status. */
-export declare const getConversationRunStatusSchema: () => Schema<string>;
-/** Schema for conversation run status.
- * @deprecated Use getConversationRunStatusSchema()
- */
-export declare const ConversationRunStatusSchema: Schema<string>;
-/** Public API contract for conversation run projection. */
-export interface ConversationRunProjection {
-    runId: string;
-    conversationId: string;
-    messageId: string;
-    latestEventId: number;
-    latestExternalEventSequence: number;
-    waitingToolCallId: string | null;
-    waitingToolName: string | null;
-    status: "pending" | "running" | "waiting_for_tool" | "completed" | "failed" | "cancelled";
-}
-/** Zod schema for get conversation run projection. */
-export declare const getConversationRunProjectionSchema: () => Schema<ConversationRunProjection>;
-/** Schema for conversation run projection.
- * @deprecated Use getConversationRunProjectionSchema()
- */
-export declare const ConversationRunProjectionSchema: Schema<ConversationRunProjection>;
-/** Public API contract for a conversation run status is active. */
-export type ActiveConversationRunStatus = Extract<ConversationRunProjection["status"], "pending" | "running" | "waiting_for_tool">;
-/** Public API contract for terminal conversation run status. */
-export type TerminalConversationRunStatus = Extract<ConversationRunProjection["status"], "completed" | "failed" | "cancelled">;
-/** Result returned from conversation run append cursor resync. */
-export type ConversationRunAppendCursorResyncResult = "advanced" | "non_appendable" | "unchanged";
-/** Public API contract for conversation run append recovery outcome. */
-export type ConversationRunAppendRecoveryOutcome = "resumed" | "stopped" | "bubbled";
-/** Public API contract for conversation run append failure outcome. */
-export type ConversationRunAppendFailureOutcome = "resumed" | "stopped" | "retry_scheduled";
-/** Public API contract for conversation run append execution outcome. */
-export type ConversationRunAppendExecutionOutcome = "resumed" | "stopped" | "retry_scheduled";
-/** Public API contract for conversation run batch flush outcome. */
-export type ConversationRunBatchFlushOutcome = "flushed" | "resumed" | "stopped" | "retry_scheduled";
-/** Public API contract for conversation run queue flush outcome. */
-export type ConversationRunQueueFlushOutcome = "flushed" | "stopped" | "retry_scheduled";
-/** Public API contract for conversation run event queue controller. */
-export interface ConversationRunEventQueueController {
-    enqueue(events: unknown[]): void;
-    flush(): Promise<{
-        outcome: "idle" | "flushed";
-        latestEventId: number;
-        latestExternalEventSequence: number;
-        pendingEventCount: number;
-        consecutiveFailures: number;
-        disabled: boolean;
-    } | {
-        outcome: "stopped";
-        latestEventId: number;
-        latestExternalEventSequence: number;
-        pendingEventCount: 0;
-        consecutiveFailures: number;
-        disabled: true;
-        disableReason?: "cursor_resyncs_exhausted" | "non_appendable" | "ignorable_append_rejection";
-    } | {
-        outcome: "retry_scheduled";
-        latestEventId: number;
-        latestExternalEventSequence: number;
-        pendingEventCount: number;
-        consecutiveFailures: number;
-        disabled: false;
-        errorMessage: string;
-    }>;
-    getSnapshot(): {
-        latestEventId: number;
-        latestExternalEventSequence: number;
-        pendingEventCount: number;
-        consecutiveFailures: number;
-        disabled: boolean;
-    };
-}
-/** Zod schema for get create conversation run accepted. */
-export declare const getCreateConversationRunAcceptedSchema: () => Schema<{
-    runId: string;
-}>;
-/** Schema for create conversation run accepted.
- * @deprecated Use getCreateConversationRunAcceptedSchema()
- */
-export declare const CreateConversationRunAcceptedSchema: Schema<{
-    runId: string;
-}>;
-/** Zod schema for get complete conversation run response. */
-export declare const getCompleteConversationRunResponseSchema: () => Schema<{
-    completed: boolean;
-    run: {
-        status: string;
-    } & {
-        runId?: string | undefined;
-        run_id?: string | undefined;
-    } & Record<string, unknown>;
-} & {} & Record<string, unknown>>;
-/** Schema for complete conversation run response.
- * @deprecated Use getCompleteConversationRunResponseSchema()
- */
-export declare const CompleteConversationRunResponseSchema: Schema<{
-    completed: boolean;
-    run: {
-        status: string;
-    } & {
-        runId?: string | undefined;
-        run_id?: string | undefined;
-    } & Record<string, unknown>;
-} & {} & Record<string, unknown>>;
-/** Response payload for append conversation run events. */
-export interface AppendConversationRunEventsResponse {
-    latestEventId: number;
-    latestExternalEventSequence: number;
-    appendedCount: number;
-    run: {
-        runId: string;
-        conversationId: string;
-        latestEventId: number;
-        latestExternalEventSequence: number;
-        [key: string]: unknown;
-    };
-}
-/** Zod schema for get append conversation run events response. */
-export declare const getAppendConversationRunEventsResponseSchema: () => Schema<AppendConversationRunEventsResponse | import("../../extensions/schema/schema-validator.js").InferShape<{
-    latestEventId: Schema<number>;
-    latestExternalEventSequence: Schema<number>;
-    appendedCount: Schema<number>;
-    run: Schema<{
-        runId: string;
-        conversationId: string;
-        latestEventId: number;
-        latestExternalEventSequence: number;
-    } & {} & Record<string, unknown>>;
-}>>;
-/** Schema for append conversation run events response.
- * @deprecated Use getAppendConversationRunEventsResponseSchema()
- */
-export declare const AppendConversationRunEventsResponseSchema: Schema<AppendConversationRunEventsResponse | import("../../extensions/schema/schema-validator.js").InferShape<{
-    latestEventId: Schema<number>;
-    latestExternalEventSequence: Schema<number>;
-    appendedCount: Schema<number>;
-    run: Schema<{
-        runId: string;
-        conversationId: string;
-        latestEventId: number;
-        latestExternalEventSequence: number;
-    } & {} & Record<string, unknown>>;
-}>>;
-/** Public API contract for conversation agent run usage. */
-export interface ConversationAgentRunUsage {
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-}
-/** Input payload for create conversation agent run. */
-export interface CreateConversationAgentRunInput {
-    authToken: string;
-    apiUrl: string;
-    conversationId: string;
-    runId?: string;
-    parentRunId?: string;
-    agentId: string;
-    implementationKind?: string | null;
-    projectId?: string | null;
-    branchId?: string | null;
-}
-/** Input payload for finalize conversation agent run. */
-export interface FinalizeConversationAgentRunInput {
-    authToken: string;
-    apiUrl: string;
-    conversationId: string;
-    runId: string;
-    status: "completed" | "failed" | "cancelled";
-    model: string;
-    provider: string;
-    usage?: ConversationAgentRunUsage;
-    terminalErrorCode?: string | null;
-    terminalErrorMessage?: string | null;
-}
+import type { ActiveConversationRunStatus, AppendConversationRunEventsResponse, ConversationRunAppendCursorResyncResult, ConversationRunAppendFailureOutcome, ConversationRunAppendRecoveryOutcome, ConversationRunEventQueueController, ConversationRunProjection, CreateConversationAgentRunInput, FinalizeConversationAgentRunInput, TerminalConversationRunStatus } from "./durable-contracts.js";
+export { AppendConversationRunEventsResponseSchema, CompleteConversationRunResponseSchema, ConversationRunProjectionSchema, ConversationRunStatusSchema, ConversationRunTargetsSchema, CreateConversationRunAcceptedSchema, getAppendConversationRunEventsResponseSchema, getCompleteConversationRunResponseSchema, getConversationRunProjectionSchema, getConversationRunStatusSchema, getConversationRunTargetsSchema, getCreateConversationRunAcceptedSchema, resolveConversationRunTargets, } from "./durable-contracts.js";
+export type { ActiveConversationRunStatus, AppendConversationRunEventsResponse, ConversationAgentRunUsage, ConversationRunAppendCursorResyncResult, ConversationRunAppendExecutionOutcome, ConversationRunAppendFailureOutcome, ConversationRunAppendRecoveryOutcome, ConversationRunBatchFlushOutcome, ConversationRunEventQueueController, ConversationRunProjection, ConversationRunQueueFlushOutcome, ConversationRunTargets, CreateConversationAgentRunInput, FinalizeConversationAgentRunInput, TerminalConversationRunStatus, } from "./durable-contracts.js";
 /** Error shape for conversation run terminal state. */
 export declare class ConversationRunTerminalStateError extends Error {
     readonly status: TerminalConversationRunStatus;