@vercel/factory 0.0.14 → 0.0.16

package/dist/api.d.mts

@@ -1,225 +1,120 @@
-import { l as AgentRouteRegistry, r as DispatchBudget } from "./dispatch-BaZS3PT8.mjs";
-import { Tt as Task, h as FactoryStores, j as Repository, wt as ExecutionReference, yt as AgentSession } from "./engine-DFHU2Pe-.mjs";
-import { z } from "zod";
+import { InboxActivity, InboxActivityItem, inboxActivityItemSchema, inboxActivitySchema } from "./inbox-activity.mjs";
+import { AgentModelConfig, ModelSettings, UpdateModelDefaults, agentModelConfigSchema, modelSettingsSchema, updateModelDefaultsSchema } from "./model-settings.mjs";
+import { SessionPreview, SessionPreviews, sessionPreviewSchema, sessionPreviewsSchema } from "./session-previews.mjs";
+import { SessionReview, SessionReviewCheck, SessionReviewIssue, SessionReviewScreenshot, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema } from "./session-review.mjs";
+import { WorkspaceGitFilesOptions, workspaceGitFilesScript } from "./workspace-files-git.mjs";
+import { WorkspaceFileEntry, WorkspaceFiles, WorkspaceFilesRequest, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspacePathSchema } from "./workspace-files.mjs";
+import { Signal } from "./schema/signal.mjs";
+import { Repository, RepositorySlug } from "./schema/repository.mjs";
+import { ExecutionReference, Task } from "./schema/task.mjs";
+import { AgentRouteRegistry } from "./agent-routes.mjs";
+import { ImageAttachment, imagePartFilename } from "./image-input.mjs";
+import { AgentSession, AgentSessionId, DirectAgentSession, ExternalAgentSession, TaskAgentSession, agentSessionIdSchema, agentSessionSchema } from "./schema/session.mjs";
+import { FactoryStores, ImageInputError, SessionConflictError } from "./store/engine.mjs";
+import { ApiPrincipal } from "./approval-contracts.mjs";
+import { ResolveImageMessageInput, ResolveImageMessageStores, ResolvedImageMessage, ResolvedImageMessagePart, resolveImageMessage } from "./api-images.mjs";
+import { DispatchBudget } from "./dispatch.mjs";
+import { UnavailableWorkspaceDiffInput, WorkspaceDiff, WorkspaceDiffFile, unavailableWorkspaceDiff, workspaceDiffFileSchema, workspaceDiffSchema } from "./workspace-diff.mjs";
+import { WorkspaceSnapshot, workspaceSnapshotSchema, workspaceSnapshotScript } from "./workspace-snapshot.mjs";
+import { WorkspaceBaseBlob, WorkspaceBaseEntry, WorkspaceDiffAssemblyOptions, assembleWorkspaceDiff } from "./workspace-diff-assembly.mjs";
+import { AnswerSessionQuestionRequest, ApiAgent, ApiAgentInput, ControlSessionRequest, CreateSessionRequest, RepositoryDetails, RepositorySummary, SendSessionMessageRequest, SessionInputResponse, SessionPage, SessionView, SubmitSessionInputRequest, answerSessionQuestionRequestSchema, apiAgentSchema, controlSessionRequestSchema, createSessionRequestSchema, repositoryDetailsSchema, repositorySummarySchema, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionViewSchema, submitSessionInputRequestSchema } from "./api-contracts.mjs";
 //#region src/api.d.ts
-declare const apiAgentSchema: z.ZodObject<{
-  id: z.ZodString;
-  description: z.ZodString;
-  routeId: z.ZodOptional<z.ZodString>;
-  requiresRepository: z.ZodBoolean;
-  requiresChange: z.ZodBoolean;
-}, z.core.$strict>;
-type ApiAgent = z.infer<typeof apiAgentSchema>;
-declare const createSessionRequestSchema: z.ZodObject<{
-  operationId: z.ZodString;
-  agent: z.ZodString;
-  repository: z.ZodOptional<z.ZodString>;
-  changeId: z.ZodOptional<z.ZodString>;
-  message: z.ZodString;
-}, z.core.$strict>;
-type CreateSessionRequest = z.infer<typeof createSessionRequestSchema>;
-declare const sessionViewSchema: z.ZodObject<{
-  session: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    id: z.ZodString;
-    owner: z.ZodString;
-    agent: z.ZodString;
-    repositoryId: z.ZodOptional<z.ZodString>;
-    routeId: z.ZodOptional<z.ZodString>;
-    message: z.ZodString;
-    changeId: z.ZodOptional<z.ZodString>;
-    taskId: z.ZodOptional<z.ZodString>;
-    execution: z.ZodOptional<z.ZodObject<{
-      provider: z.ZodString;
-      sessionId: z.ZodString;
-      environmentId: z.ZodOptional<z.ZodString>;
-      harness: z.ZodOptional<z.ZodString>;
-      traceId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    notifications: z.ZodDefault<z.ZodArray<z.ZodObject<{
-      eventId: z.ZodString;
-      repositoryIds: z.ZodArray<z.ZodString>;
-      taskId: z.ZodOptional<z.ZodString>;
-      changeId: z.ZodOptional<z.ZodString>;
-      replyTo: z.ZodObject<{
-        channel: z.ZodString;
-        address: z.ZodString;
-      }, z.core.$strict>;
-      outcome: z.ZodEnum<{
-        message: "message";
-        accepted: "accepted";
-        started: "started";
-        succeeded: "succeeded";
-        failed: "failed";
-        needs_human: "needs_human";
-        question: "question";
-        digest: "digest";
-        rolled_back: "rolled_back";
-        budget_warning: "budget_warning";
-        budget_exhausted: "budget_exhausted";
-      }>;
-      data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strict>>>;
-    createdAt: z.ZodISODateTime;
-  }, z.core.$strict>;
-  task: z.ZodNullable<z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    id: z.ZodString;
-    repositoryIds: z.ZodArray<z.ZodString>;
-    kind: z.ZodString;
-    area: z.ZodOptional<z.ZodString>;
-    state: z.ZodEnum<{
-      succeeded: "succeeded";
-      failed: "failed";
-      needs_human: "needs_human";
-      queued: "queued";
-      running: "running";
-      stalled: "stalled";
-      verifying: "verifying";
-      cancelled: "cancelled";
-    }>;
-    approval: z.ZodOptional<z.ZodEnum<{
-      required: "required";
-      granted: "granted";
-      denied: "denied";
-    }>>;
-    origin: z.ZodObject<{
-      signalId: z.ZodOptional<z.ZodString>;
-      parentTaskId: z.ZodOptional<z.ZodString>;
-      operator: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    replyTo: z.ZodObject<{
-      channel: z.ZodString;
-      address: z.ZodString;
-    }, z.core.$strict>;
-    attempt: z.ZodNumber;
-    execution: z.ZodOptional<z.ZodObject<{
-      provider: z.ZodString;
-      sessionId: z.ZodString;
-      environmentId: z.ZodOptional<z.ZodString>;
-      harness: z.ZodOptional<z.ZodString>;
-      traceId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
-    stalledAt: z.ZodOptional<z.ZodISODateTime>;
-    stalledReason: z.ZodOptional<z.ZodString>;
-    reservedUsd: z.ZodOptional<z.ZodNumber>;
-    reservedAt: z.ZodOptional<z.ZodISODateTime>;
-    usage: z.ZodOptional<z.ZodObject<{
-      costUsd: z.ZodNumber;
-      inputTokens: z.ZodNumber;
-      outputTokens: z.ZodNumber;
-      cacheReadTokens: z.ZodNumber;
-      cacheWriteTokens: z.ZodNumber;
-      steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
-    }, z.core.$strict>>;
-    settledUsd: z.ZodOptional<z.ZodNumber>;
-    question: z.ZodOptional<z.ZodObject<{
-      text: z.ZodString;
-      options: z.ZodArray<z.ZodString>;
-      answer: z.ZodOptional<z.ZodString>;
-      answeredBy: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    questionTaskId: z.ZodOptional<z.ZodString>;
-    answerEventIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    changeId: z.ZodOptional<z.ZodString>;
-    reportRef: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodISODateTime;
-    updatedAt: z.ZodISODateTime;
-  }, z.core.$strict>>;
-  execution: z.ZodNullable<z.ZodObject<{
-    provider: z.ZodString;
-    sessionId: z.ZodString;
-    environmentId: z.ZodOptional<z.ZodString>;
-    harness: z.ZodOptional<z.ZodString>;
-    traceId: z.ZodOptional<z.ZodString>;
-  }, z.core.$strict>>;
-  question: z.ZodNullable<z.ZodObject<{
-    schemaVersion: z.ZodLiteral<1>;
-    id: z.ZodString;
-    repositoryIds: z.ZodArray<z.ZodString>;
-    kind: z.ZodString;
-    area: z.ZodOptional<z.ZodString>;
-    state: z.ZodEnum<{
-      succeeded: "succeeded";
-      failed: "failed";
-      needs_human: "needs_human";
-      queued: "queued";
-      running: "running";
-      stalled: "stalled";
-      verifying: "verifying";
-      cancelled: "cancelled";
-    }>;
-    approval: z.ZodOptional<z.ZodEnum<{
-      required: "required";
-      granted: "granted";
-      denied: "denied";
-    }>>;
-    origin: z.ZodObject<{
-      signalId: z.ZodOptional<z.ZodString>;
-      parentTaskId: z.ZodOptional<z.ZodString>;
-      operator: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    replyTo: z.ZodObject<{
-      channel: z.ZodString;
-      address: z.ZodString;
-    }, z.core.$strict>;
-    attempt: z.ZodNumber;
-    execution: z.ZodOptional<z.ZodObject<{
-      provider: z.ZodString;
-      sessionId: z.ZodString;
-      environmentId: z.ZodOptional<z.ZodString>;
-      harness: z.ZodOptional<z.ZodString>;
-      traceId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    lastProgressAt: z.ZodOptional<z.ZodISODateTime>;
-    stalledAt: z.ZodOptional<z.ZodISODateTime>;
-    stalledReason: z.ZodOptional<z.ZodString>;
-    reservedUsd: z.ZodOptional<z.ZodNumber>;
-    reservedAt: z.ZodOptional<z.ZodISODateTime>;
-    usage: z.ZodOptional<z.ZodObject<{
-      costUsd: z.ZodNumber;
-      inputTokens: z.ZodNumber;
-      outputTokens: z.ZodNumber;
-      cacheReadTokens: z.ZodNumber;
-      cacheWriteTokens: z.ZodNumber;
-      steps: z.ZodRecord<z.ZodString, z.ZodNumber>;
-    }, z.core.$strict>>;
-    settledUsd: z.ZodOptional<z.ZodNumber>;
-    question: z.ZodOptional<z.ZodObject<{
-      text: z.ZodString;
-      options: z.ZodArray<z.ZodString>;
-      answer: z.ZodOptional<z.ZodString>;
-      answeredBy: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-    questionTaskId: z.ZodOptional<z.ZodString>;
-    answerEventIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    changeId: z.ZodOptional<z.ZodString>;
-    reportRef: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodISODateTime;
-    updatedAt: z.ZodISODateTime;
-  }, z.core.$strict>>;
-}, z.core.$strict>;
-type SessionView = z.infer<typeof sessionViewSchema>;
+/** Identifies the session launch requested by the Factory HTTP API. */
+interface FactoryApiStartInput {
+  readonly session: AgentSession;
+  readonly task: Task | null;
+  readonly message: string;
+  readonly operationId: string;
+  readonly attachments?: readonly ImageAttachment[];
+}
+/** Identifies one request forwarded from the Factory API to an active execution. */
+interface FactoryApiForwardInput {
+  readonly session: AgentSession;
+  readonly execution: ExecutionReference;
+  readonly path: string;
+  readonly request: Request;
+}
+/** Identifies a file inspection in an authorized execution workspace. */
+interface FactoryApiWorkspaceFilesInput extends FactoryApiWorkspaceDiffInput {
+  readonly query: WorkspaceFilesRequest;
+}
+/** Identifies the active execution whose workspace diff the Factory API requests. */
+interface FactoryApiWorkspaceDiffInput {
+  readonly session: AgentSession;
+  readonly execution: ExecutionReference;
+  readonly signal: AbortSignal;
+}
+/** Authorized session projection supplied to an application-owned review reader. */
+interface FactoryApiSessionReviewInput {
+  readonly current: SessionView;
+  /** Authorized current Task snapshots, including delegated workflow-owned work. */
+  readonly tasks: readonly Task[];
+  readonly signal: AbortSignal;
+}
+/** Authorized work supplied to an application-owned preview reader. */
+interface FactoryApiSessionPreviewsInput {
+  readonly current: SessionView;
+  readonly tasks: readonly Task[];
+  readonly signal: AbortSignal;
+}
+/** Authenticated caller and repository scope supplied to an external activity reader. */
+interface FactoryApiInboxActivityInput {
+  /** Authenticated caller; the reader must apply its application's source access policy. */
+  readonly principal: ApiPrincipal;
+  /** Configured repositories that have not been disabled. Never expand this scope. */
+  readonly repositories: readonly RepositorySlug[];
+  readonly signal: AbortSignal;
+}
+/** Application-owned dependencies and authorization policies for the Factory HTTP API. */
 interface FactoryApiOptions {
+  /** Optional application-owned catalogs; the start adapter must honor each persisted model choice. */
+  agentModels?: readonly AgentModelConfig[];
+  /** Explicit policy for saving shared repository defaults; absent denies mutations. */
+  canEditModelDefaults?(principal: ApiPrincipal, repository: Repository): Promise<boolean>;
   stores: FactoryStores;
-  agents: readonly ApiAgent[];
+  agents: readonly ApiAgentInput[];
   routes: AgentRouteRegistry;
-  repositories: readonly string[];
+  repositories: readonly RepositorySlug[];
   budget: DispatchBudget;
-  authenticate(request: Request): Promise<{
+  authenticate(request: Request): Promise<ApiPrincipal | Response>;
+  /** Exact provider-qualified actors allowed to read and decide approvals. Absent disables approval access. */
+  operators?: readonly string[];
+  /** Explicit operator policy for inspecting and controlling external work; absent denies access. */
+  canAccessTask?(operator: {
     id: string;
-  } | Response>;
-  ensureRepository(slug: string): Promise<Repository>;
-  start(session: AgentSession, task: Task | null, message: string, operationId: string): Promise<ExecutionReference>;
-  forward(session: AgentSession, execution: ExecutionReference, path: string, request: Request): Promise<Response>;
-  reportError?(error: unknown): void;
+  }, task: Task): Promise<boolean>;
+  /** Exposed conversational agent used for separately budgeted follow-up investigations. */
+  continuationAgent?: string;
+  /** Application-owned validation and launch for a stopped intake attempt, including supported Signal sources. */
+  retryIntake?(signal: Signal, options: {
+    expectedAttempt: number;
+    by: string;
+  }): Promise<Signal>;
+  resumeTask?(task: Task): Promise<ExecutionReference>;
+  ensureRepository(slug: RepositorySlug): Promise<Repository>;
+  start(input: FactoryApiStartInput): Promise<ExecutionReference>;
+  forward(input: FactoryApiForwardInput): Promise<Response>;
+  /** Optional evidence reader; owns source selection, image access, and response limits. */
+  sessionReview?(input: FactoryApiSessionReviewInput): Promise<SessionReview>;
+  /** Optional read-only preview reader; owns source selection, link access, expiry, and limits. */
+  sessionPreviews?(input: FactoryApiSessionPreviewsInput): Promise<SessionPreviews>;
+  /** Optional external attention reader; owns caller authorization, sources, caching, and limits. */
+  inboxActivity?(input: FactoryApiInboxActivityInput): Promise<InboxActivity>;
+  workspaceDiff?(input: FactoryApiWorkspaceDiffInput): Promise<WorkspaceDiff>;
+  /** Optional provider-neutral reader for files and directories at immutable revisions. */
+  workspaceFiles?(input: FactoryApiWorkspaceFilesInput): Promise<WorkspaceFiles>;
+  reportError?(error: unknown, context: {
+    method: string;
+    path: string;
+  }): void;
+}
+/** Authenticated Factory HTTP handler plus the launcher for durable continuation Tasks. */
+interface FactoryApi {
+  handle(request: Request): Promise<Response>;
+  startContinuation(task: Task): Promise<ExecutionReference>;
 }
-declare function createFactoryApi(options: FactoryApiOptions): {
-  handle: (request: Request) => Promise<Response>;
-};
+/** Creates the authenticated request handler for the public Factory HTTP API. */
+declare function createFactoryApi(options: FactoryApiOptions): FactoryApi;
 //#endregion
-export { ApiAgent, CreateSessionRequest, FactoryApiOptions, SessionView, apiAgentSchema, createFactoryApi, createSessionRequestSchema, sessionViewSchema };
+export { type AgentModelConfig, type AgentSession, type AgentSessionId, type AnswerSessionQuestionRequest, type ApiAgent, type ApiAgentInput, type ApiPrincipal, type ControlSessionRequest, type CreateSessionRequest, type DirectAgentSession, type ExternalAgentSession, FactoryApi, FactoryApiForwardInput, FactoryApiInboxActivityInput, FactoryApiOptions, FactoryApiSessionPreviewsInput, FactoryApiSessionReviewInput, FactoryApiStartInput, FactoryApiWorkspaceDiffInput, FactoryApiWorkspaceFilesInput, ImageInputError, type InboxActivity, type InboxActivityItem, type ModelSettings, type RepositoryDetails, type RepositorySummary, type ResolveImageMessageInput, type ResolveImageMessageStores, type ResolvedImageMessage, type ResolvedImageMessagePart, type SendSessionMessageRequest, SessionConflictError, type SessionInputResponse, type SessionPage, type SessionPreview, type SessionPreviews, type SessionReview, type SessionReviewCheck, type SessionReviewIssue, type SessionReviewScreenshot, type SessionView, type SubmitSessionInputRequest, type TaskAgentSession, type UnavailableWorkspaceDiffInput, type UpdateModelDefaults, type WorkspaceBaseBlob, type WorkspaceBaseEntry, type WorkspaceDiff, type WorkspaceDiffAssemblyOptions, type WorkspaceDiffFile, type WorkspaceFileEntry, type WorkspaceFiles, type WorkspaceFilesRequest, type WorkspaceGitFilesOptions, type WorkspaceSnapshot, agentModelConfigSchema, agentSessionIdSchema, agentSessionSchema, answerSessionQuestionRequestSchema, apiAgentSchema, assembleWorkspaceDiff, controlSessionRequestSchema, createFactoryApi, createSessionRequestSchema, imagePartFilename, inboxActivityItemSchema, inboxActivitySchema, modelSettingsSchema, repositoryDetailsSchema, repositorySummarySchema, resolveImageMessage, sendSessionMessageRequestSchema, sessionInputResponseSchema, sessionPageSchema, sessionPreviewSchema, sessionPreviewsSchema, sessionReviewCheckSchema, sessionReviewIssueSchema, sessionReviewSchema, sessionReviewScreenshotSchema, sessionViewSchema, submitSessionInputRequestSchema, unavailableWorkspaceDiff, updateModelDefaultsSchema, workspaceDiffFileSchema, workspaceDiffSchema, workspaceFileContentSchema, workspaceFileEntrySchema, workspaceFilesRequestSchema, workspaceFilesSchema, workspaceGitFilesScript, workspacePathSchema, workspaceSnapshotSchema, workspaceSnapshotScript };
 //# sourceMappingURL=api.d.mts.map