@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/adapters/types.d.ts

@@ -1,4 +1,6 @@
-import type { MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler } from "../adapter.js";
+import type { ChatToolResult, MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler, OfficeAddress, SubagentProgressSnapshot } from "../adapter.js";
+import type { Office } from "../office/types.js";
+import type { Attachment } from "../types.js";
 export type ChatResponseErrorOperation = "respond" | "replace_response" | "respond_diagnostic" | "set_working";
 export interface ChatResponseErrorContext {
     platform: string;
@@ -26,23 +28,142 @@ export interface RetryOptions {
 }
 export interface ResolveStopTargetInput {
     handler: MessagingEventHandler;
-    conversationId: string;
+    /** The office whose runtime state may be stopped. */
+    address: OfficeAddress;
     /** Session key derived from the current message; checked first when present. */
     sessionKey?: string;
 }
-export interface BufferedResponseStreamOptions {
-    minFlushIntervalMs?: number;
-    minFlushChars?: number;
-    now?: () => number;
+interface ProgressiveStreamTransport {
+    start(text: string): Promise<string>;
+    append(messageId: string, delta: string): Promise<void>;
+    stop(messageId: string): Promise<void>;
+    /**
+     * Withhold an append until this many characters have accumulated. A
+     * streaming transport is usually rate-limited per call rather than per byte,
+     * so forwarding every token spends the budget on latency nobody perceives.
+     * The final render flushes whatever is left before stopping, so buffering
+     * can never drop text. Omit for no buffering.
+     */
+    minDeltaChars?: number;
+}
+export interface ProgressiveRendererPlatform {
+    label: string;
+    maxLength: number;
+    /**
+     * Shortest gap between redraws of a streaming response, measured from the
+     * end of the previous one. Platforms meter edits per channel at different
+     * rates; the default suits the tightest of them. Zero redraws on every
+     * delta, which only a platform with no such limit can afford.
+     */
+    flushIntervalMs?: number;
+    initialResponseId?: string | null;
+    formatContinuation: (partNum: number) => string;
+    errorPrefix: string;
+    sanitize?: (text: string) => string;
+    workingIndicator?: string;
+    formatProvisional?: (text: string, working: boolean) => string;
+    prepareSource?: (text: string, working: boolean) => string;
+    onWorkingChanged?: (working: boolean, responseId: string | null) => Promise<void>;
+    setTyping?: (isTyping: boolean, responseId: string | null) => Promise<void>;
+    /** Terminal hook. Awaited, so it may finish sending before the run ends. */
+    onFinish?: (text: string, responseId: string | null) => void | Promise<void>;
+    /** Whether `respond` calls are complete messages that should be logged immediately. */
+    logIntermediateResponses?: boolean;
+    /** Whether the platform accepts incremental response deltas. */
+    supportsDeltas?: boolean;
+    /** Native stream operations, when this reply target supports them. */
+    stream?: ProgressiveStreamTransport;
+    /** Re-render a finished response when the provisional stream lacked structure. */
+    needsCanonicalRender?: (text: string) => boolean;
+    formatSubagentProgress?: (progress: SubagentProgressSnapshot) => string;
+    typing?: {
+        send: () => Promise<unknown>;
+        intervalMs: number;
+        stopOnSend?: boolean;
+    };
+    formatToolResult: (result: ChatToolResult) => string;
+    /** Stable platform context plus the current response identity for error reporting. */
+    responseErrorContext?: (responseId: string | null) => Omit<ChatResponseErrorContext, "operation" | "extra">;
+    /** @deprecated Provide `responseErrorContext`; the renderer now owns reporting. */
+    reportError?: (err: unknown, operation: ChatResponseErrorOperation, extra: Record<string, unknown>, responseId: string | null) => void;
+    notifySendFailure?: (errorMessage: string) => Promise<void>;
+    post: (text: string) => Promise<string>;
+    update: (id: string, text: string) => Promise<void>;
+    postExtra: (text: string, responseId: string | null) => Promise<string | number | void>;
+    postDiagnostic?: (text: string, options: {
+        style?: "muted" | "error";
+    }, responseId: string | null) => Promise<Array<string | number>>;
+    delete?: (id: string) => Promise<void>;
+    deleteExtra?: (id: string | number) => Promise<void>;
+    logBotResponse?: (text: string, id: string) => void;
+    uploadFile?: (filePath: string, title?: string) => Promise<void>;
+    uploadFallbackNote?: (name: string) => string;
+    react?: (emoji: string) => Promise<void>;
+    /**
+     * Whether a send failure is a length rejection, as opposed to a rate limit
+     * or an outage. Without this the fallback swallows every error, so a
+     * transient 429 gets reported to the reader as "message too long" and the
+     * response is truncated for no reason.
+     */
+    isTooLongError?: (err: unknown) => boolean;
+    /** Handle a Slack-style length rejection and return the canonical fallback text. */
+    handleTooLong?: (text: string, operation: "render" | "replace", options: {
+        createOverflowLink?: () => string;
+    } | undefined, responseId: string | null, write: (text: string) => Promise<void>, getResponseId: () => string | null) => Promise<{
+        text: string;
+        prefixLength?: number;
+    }>;
+}
+/** How intake resolved a message. Callers branch on this instead of passing callbacks. */
+export type MessageIntakeOutcome = "magic-word" | "not-triggered" | "rejected-busy" | "enqueued";
+/** Platform policy for the magic-word step, stated as data. */
+export interface MagicWordIntakeOptions {
+    /**
+     * Raw user-typed text to match when `eventBase.text` is decorated for the
+     * agent (e.g. GitHub review-comment framing). Defaults to `eventBase.text`.
+     */
+    text?: string;
+    /**
+     * Whether the message addressed the bot (mention, DM, slash form). The idle
+     * "Nothing running." reply is suppressed for unaddressed messages.
+     */
+    addressed: boolean;
+    /**
+     * How far a stop may widen when the direct session key is not running:
+     * "top-level" widens to the single running scoped session only from the
+     * persistent conversation session, "always" widens unconditionally,
+     * "never" stops only exact matches.
+     */
+    scopeFallback: "top-level" | "always" | "never";
+}
+/** One platform file to save into an office's attachments directory. */
+export interface IncomingAttachment {
+    /** Original file name as the platform reports it. */
+    name: string;
+    /** Epoch ms used in the stored filename; defaults to the time of saving. */
+    timestampMs?: number;
+    /** Fetch the file and write it to destPath (the parent directory exists). */
+    download(destPath: string): Promise<void>;
 }
-export interface BufferedResponseStreamSink {
-    flush(text: string): Promise<void>;
-    finish(text: string): Promise<void>;
+/** Outcome of saving incoming attachments; error policy stays with the adapter. */
+export interface SavedAttachments {
+    saved: Attachment[];
+    failed: {
+        name: string;
+        error: unknown;
+    }[];
 }
 export interface MessageIntakeOptions<TEvent extends ConversationEvent> {
     eventBase: TEvent;
-    workingDir: string | undefined;
+    /** The event's Conversation office; absent when auto-reply is unconfigured (embedders). */
+    office: Office | undefined;
     isAutoReplyCandidate: boolean;
+    magicWord: MagicWordIntakeOptions;
+    /**
+     * "reject" bounces a new message while its session is already running
+     * (with an "Already working" reply); "queue" lines it up behind the run.
+     */
+    busyPolicy: "queue" | "reject";
     logEntryBase: Record<string, unknown>;
     log?: (entry: Record<string, unknown>) => void;
     processAttachments: () => Promise<unknown[]>;
@@ -51,8 +172,7 @@ export interface MessageIntakeOptions<TEvent extends ConversationEvent> {
     handler: MessagingEventHandler;
     bot: MessagingBot;
     createContext: (event: TEvent) => ConversationContext;
-    beforeEnqueue?: (event: TEvent) => Promise<boolean> | boolean;
-    onNotTriggered?: () => void;
     deferAttachmentsUntilRun?: boolean;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,0BAA0B,GAClC,SAAS,GACT,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,CAAC;AAElB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,0BAA0B,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,0BAA0B,EACrC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,IAAI,CAAC;AAEV,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,aAAa,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC;IACvC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB,CAAC,MAAM,SAAS,iBAAiB;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/C,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC/D,OAAO,EAAE,qBAAqB,CAAC;IAC/B,GAAG,EAAE,YAAY,CAAC;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,mBAAmB,CAAC;IACtD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9D,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"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"}

package/dist/adapters/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  MessagingBot,\n  ConversationContext,\n  ConversationEvent,\n  MessagingEventHandler,\n} from \"../adapter.js\";\n\nexport type ChatResponseErrorOperation =\n  | \"respond\"\n  | \"replace_response\"\n  | \"respond_diagnostic\"\n  | \"set_working\";\n\nexport interface ChatResponseErrorContext {\n  platform: string;\n  conversationId: string;\n  messageId: string;\n  sessionKey: string;\n  conversationKind: string;\n  operation: ChatResponseErrorOperation;\n  channelId?: string;\n  chatId?: number;\n  responseMessageId?: string | number | null;\n  threadTs?: string;\n  replyTargetId?: string;\n  replyToId?: number | null;\n  isThreaded?: boolean;\n  extra?: Record<string, unknown>;\n}\n\nexport type ChatResponseErrorReporter = (\n  err: unknown,\n  operation: ChatResponseErrorOperation,\n  extra?: Record<string, unknown>,\n) => void;\n\nexport interface RetryOptions {\n  /** Predicate that returns true when an error is worth retrying (rate limit, transient 5xx, etc.). */\n  isRateLimited: (err: Error) => boolean;\n  /** Total attempts including the first call. */\n  maxAttempts?: number;\n  baseDelayMs?: number;\n}\n\nexport interface ResolveStopTargetInput {\n  handler: MessagingEventHandler;\n  conversationId: string;\n  /** Session key derived from the current message; checked first when present. */\n  sessionKey?: string;\n}\n\nexport interface BufferedResponseStreamOptions {\n  minFlushIntervalMs?: number;\n  minFlushChars?: number;\n  now?: () => number;\n}\n\nexport interface BufferedResponseStreamSink {\n  flush(text: string): Promise<void>;\n  finish(text: string): Promise<void>;\n}\n\nexport interface MessageIntakeOptions<TEvent extends ConversationEvent> {\n  eventBase: TEvent;\n  workingDir: string | undefined;\n  isAutoReplyCandidate: boolean;\n  logEntryBase: Record<string, unknown>;\n  log?: (entry: Record<string, unknown>) => void;\n  processAttachments: () => Promise<unknown[]>;\n  queueKey: string;\n  enqueue: (queueKey: string, work: () => Promise<void>) => void;\n  handler: MessagingEventHandler;\n  bot: MessagingBot;\n  createContext: (event: TEvent) => ConversationContext;\n  beforeEnqueue?: (event: TEvent) => Promise<boolean> | boolean;\n  onNotTriggered?: () => void;\n  deferAttachmentsUntilRun?: boolean;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ChatToolResult,\n  MessagingBot,\n  ConversationContext,\n  ConversationEvent,\n  MessagingEventHandler,\n  OfficeAddress,\n  SubagentProgressSnapshot,\n} from \"../adapter.js\";\nimport type { Office } from \"../office/types.js\";\nimport type { Attachment } from \"../types.js\";\n\nexport type ChatResponseErrorOperation =\n  | \"respond\"\n  | \"replace_response\"\n  | \"respond_diagnostic\"\n  | \"set_working\";\n\nexport interface ChatResponseErrorContext {\n  platform: string;\n  conversationId: string;\n  messageId: string;\n  sessionKey: string;\n  conversationKind: string;\n  operation: ChatResponseErrorOperation;\n  channelId?: string;\n  chatId?: number;\n  responseMessageId?: string | number | null;\n  threadTs?: string;\n  replyTargetId?: string;\n  replyToId?: number | null;\n  isThreaded?: boolean;\n  extra?: Record<string, unknown>;\n}\n\nexport type ChatResponseErrorReporter = (\n  err: unknown,\n  operation: ChatResponseErrorOperation,\n  extra?: Record<string, unknown>,\n) => void;\n\nexport interface RetryOptions {\n  /** Predicate that returns true when an error is worth retrying (rate limit, transient 5xx, etc.). */\n  isRateLimited: (err: Error) => boolean;\n  /** Total attempts including the first call. */\n  maxAttempts?: number;\n  baseDelayMs?: number;\n}\n\nexport interface ResolveStopTargetInput {\n  handler: MessagingEventHandler;\n  /** The office whose runtime state may be stopped. */\n  address: OfficeAddress;\n  /** Session key derived from the current message; checked first when present. */\n  sessionKey?: string;\n}\n\ninterface ProgressiveStreamTransport {\n  start(text: string): Promise<string>;\n  append(messageId: string, delta: string): Promise<void>;\n  stop(messageId: string): Promise<void>;\n  /**\n   * Withhold an append until this many characters have accumulated. A\n   * streaming transport is usually rate-limited per call rather than per byte,\n   * so forwarding every token spends the budget on latency nobody perceives.\n   * The final render flushes whatever is left before stopping, so buffering\n   * can never drop text. Omit for no buffering.\n   */\n  minDeltaChars?: number;\n}\n\nexport interface ProgressiveRendererPlatform {\n  label: string;\n  maxLength: number;\n  /**\n   * Shortest gap between redraws of a streaming response, measured from the\n   * end of the previous one. Platforms meter edits per channel at different\n   * rates; the default suits the tightest of them. Zero redraws on every\n   * delta, which only a platform with no such limit can afford.\n   */\n  flushIntervalMs?: number;\n  initialResponseId?: string | null;\n  formatContinuation: (partNum: number) => string;\n  errorPrefix: string;\n  sanitize?: (text: string) => string;\n  workingIndicator?: string;\n  formatProvisional?: (text: string, working: boolean) => string;\n  prepareSource?: (text: string, working: boolean) => string;\n  onWorkingChanged?: (working: boolean, responseId: string | null) => Promise<void>;\n  setTyping?: (isTyping: boolean, responseId: string | null) => Promise<void>;\n  /** Terminal hook. Awaited, so it may finish sending before the run ends. */\n  onFinish?: (text: string, responseId: string | null) => void | Promise<void>;\n  /** Whether `respond` calls are complete messages that should be logged immediately. */\n  logIntermediateResponses?: boolean;\n  /** Whether the platform accepts incremental response deltas. */\n  supportsDeltas?: boolean;\n  /** Native stream operations, when this reply target supports them. */\n  stream?: ProgressiveStreamTransport;\n  /** Re-render a finished response when the provisional stream lacked structure. */\n  needsCanonicalRender?: (text: string) => boolean;\n  formatSubagentProgress?: (progress: SubagentProgressSnapshot) => string;\n  typing?: {\n    send: () => Promise<unknown>;\n    intervalMs: number;\n    stopOnSend?: boolean;\n  };\n  formatToolResult: (result: ChatToolResult) => string;\n  /** Stable platform context plus the current response identity for error reporting. */\n  responseErrorContext?: (\n    responseId: string | null,\n  ) => Omit<ChatResponseErrorContext, \"operation\" | \"extra\">;\n  /** @deprecated Provide `responseErrorContext`; the renderer now owns reporting. */\n  reportError?: (\n    err: unknown,\n    operation: ChatResponseErrorOperation,\n    extra: Record<string, unknown>,\n    responseId: string | null,\n  ) => void;\n  notifySendFailure?: (errorMessage: string) => Promise<void>;\n  post: (text: string) => Promise<string>;\n  update: (id: string, text: string) => Promise<void>;\n  postExtra: (text: string, responseId: string | null) => Promise<string | number | void>;\n  postDiagnostic?: (\n    text: string,\n    options: { style?: \"muted\" | \"error\" },\n    responseId: string | null,\n  ) => Promise<Array<string | number>>;\n  delete?: (id: string) => Promise<void>;\n  deleteExtra?: (id: string | number) => Promise<void>;\n  logBotResponse?: (text: string, id: string) => void;\n  uploadFile?: (filePath: string, title?: string) => Promise<void>;\n  uploadFallbackNote?: (name: string) => string;\n  react?: (emoji: string) => Promise<void>;\n  /**\n   * Whether a send failure is a length rejection, as opposed to a rate limit\n   * or an outage. Without this the fallback swallows every error, so a\n   * transient 429 gets reported to the reader as \"message too long\" and the\n   * response is truncated for no reason.\n   */\n  isTooLongError?: (err: unknown) => boolean;\n  /** Handle a Slack-style length rejection and return the canonical fallback text. */\n  handleTooLong?: (\n    text: string,\n    operation: \"render\" | \"replace\",\n    options: { createOverflowLink?: () => string } | undefined,\n    responseId: string | null,\n    write: (text: string) => Promise<void>,\n    getResponseId: () => string | null,\n  ) => Promise<{ text: string; prefixLength?: number }>;\n}\n\n/** How intake resolved a message. Callers branch on this instead of passing callbacks. */\nexport type MessageIntakeOutcome = \"magic-word\" | \"not-triggered\" | \"rejected-busy\" | \"enqueued\";\n\n/** Platform policy for the magic-word step, stated as data. */\nexport interface MagicWordIntakeOptions {\n  /**\n   * Raw user-typed text to match when `eventBase.text` is decorated for the\n   * agent (e.g. GitHub review-comment framing). Defaults to `eventBase.text`.\n   */\n  text?: string;\n  /**\n   * Whether the message addressed the bot (mention, DM, slash form). The idle\n   * \"Nothing running.\" reply is suppressed for unaddressed messages.\n   */\n  addressed: boolean;\n  /**\n   * How far a stop may widen when the direct session key is not running:\n   * \"top-level\" widens to the single running scoped session only from the\n   * persistent conversation session, \"always\" widens unconditionally,\n   * \"never\" stops only exact matches.\n   */\n  scopeFallback: \"top-level\" | \"always\" | \"never\";\n}\n\n/** One platform file to save into an office's attachments directory. */\nexport interface IncomingAttachment {\n  /** Original file name as the platform reports it. */\n  name: string;\n  /** Epoch ms used in the stored filename; defaults to the time of saving. */\n  timestampMs?: number;\n  /** Fetch the file and write it to destPath (the parent directory exists). */\n  download(destPath: string): Promise<void>;\n}\n\n/** Outcome of saving incoming attachments; error policy stays with the adapter. */\nexport interface SavedAttachments {\n  saved: Attachment[];\n  failed: { name: string; error: unknown }[];\n}\n\nexport interface MessageIntakeOptions<TEvent extends ConversationEvent> {\n  eventBase: TEvent;\n  /** The event's Conversation office; absent when auto-reply is unconfigured (embedders). */\n  office: Office | undefined;\n  isAutoReplyCandidate: boolean;\n  magicWord: MagicWordIntakeOptions;\n  /**\n   * \"reject\" bounces a new message while its session is already running\n   * (with an \"Already working\" reply); \"queue\" lines it up behind the run.\n   */\n  busyPolicy: \"queue\" | \"reject\";\n  logEntryBase: Record<string, unknown>;\n  log?: (entry: Record<string, unknown>) => void;\n  processAttachments: () => Promise<unknown[]>;\n  queueKey: string;\n  enqueue: (queueKey: string, work: () => Promise<void>) => void;\n  handler: MessagingEventHandler;\n  bot: MessagingBot;\n  createContext: (event: TEvent) => ConversationContext;\n  deferAttachmentsUntilRun?: boolean;\n}\n"]}

package/dist/agent-events.d.ts

@@ -1,5 +1,6 @@
-import type { ServerResponse } from "http";
+import type { IncomingMessage, ServerResponse } from "node:http";
 import type { AgentEventEnvelope } from "./types.js";
 export declare function emitAgentEvent(event: AgentEventEnvelope): void;
-export declare function addAgentEventStreamClient(res: ServerResponse): () => void;
+/** The `/api/agent-events/stream` SSE endpoint (optionally token-gated). */
+export declare function handleAgentEventsRequest(req: IncomingMessage, res: ServerResponse, url: URL): boolean;
 //# sourceMappingURL=agent-events.d.ts.map

package/dist/agent-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-events.d.ts","sourceRoot":"","sources":["../src/agent-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAK9D;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,IAAI,CAkBzE"}
+{"version":3,"file":"agent-events.d.ts","sourceRoot":"","sources":["../src/agent-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKrD,wBAAgB,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAK9D;AAsBD,4EAA4E;AAC5E,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,GAAG,GACP,OAAO,CAiBT"}

package/dist/agent-events.js

@@ -1,3 +1,4 @@
+import { readEnv } from "./env-manifest.js";
 const clients = new Set();
 let nextEventId = 1;
 export function emitAgentEvent(event) {
@@ -6,7 +7,7 @@ export function emitAgentEvent(event) {
         client.write(payload);
     }
 }
-export function addAgentEventStreamClient(res) {
+function addAgentEventStreamClient(res) {
     clients.add(res);
     res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -23,4 +24,21 @@ export function addAgentEventStreamClient(res) {
         res.end();
     };
 }
+/** The `/api/agent-events/stream` SSE endpoint (optionally token-gated). */
+export function handleAgentEventsRequest(req, res, url) {
+    if (req.method !== "GET" || url.pathname !== "/api/agent-events/stream") {
+        return false;
+    }
+    const expectedToken = readEnv("AGENT_EVENTS_TOKEN");
+    const auth = req.headers.authorization ?? "";
+    const queryToken = url.searchParams.get("token") ?? "";
+    if (expectedToken && auth !== `Bearer ${expectedToken}` && queryToken !== expectedToken) {
+        res.writeHead(401, { "Content-Type": "text/plain; charset=utf-8" });
+        res.end("unauthorized");
+        return true;
+    }
+    const cleanup = addAgentEventStreamClient(res);
+    req.on("close", cleanup);
+    return true;
+}
 //# sourceMappingURL=agent-events.js.map

package/dist/agent-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-events.js","sourceRoot":"","sources":["../src/agent-events.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC1C,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,MAAM,UAAU,cAAc,CAAC,KAAyB;IACtD,MAAM,OAAO,GAAG,OAAO,WAAW,EAAE,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACzF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAmB;IAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,cAAc,EAAE,mBAAmB;QACnC,eAAe,EAAE,wBAAwB;QACzC,UAAU,EAAE,YAAY;QACxB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1E,SAAS,CAAC,KAAK,EAAE,CAAC;IAElB,OAAO,GAAG,EAAE;QACV,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { ServerResponse } from \"http\";\nimport type { AgentEventEnvelope } from \"./types.js\";\n\nconst clients = new Set<ServerResponse>();\nlet nextEventId = 1;\n\nexport function emitAgentEvent(event: AgentEventEnvelope): void {\n  const payload = `id: ${nextEventId++}\\nevent: agent\\ndata: ${JSON.stringify(event)}\\n\\n`;\n  for (const client of clients) {\n    client.write(payload);\n  }\n}\n\nexport function addAgentEventStreamClient(res: ServerResponse): () => void {\n  clients.add(res);\n  res.writeHead(200, {\n    \"Content-Type\": \"text/event-stream\",\n    \"Cache-Control\": \"no-cache, no-transform\",\n    Connection: \"keep-alive\",\n    \"X-Accel-Buffering\": \"no\",\n  });\n  res.write(`: connected\\n\\n`);\n\n  const keepAlive = setInterval(() => res.write(`: keepalive\\n\\n`), 25_000);\n  keepAlive.unref();\n\n  return () => {\n    clearInterval(keepAlive);\n    clients.delete(res);\n    res.end();\n  };\n}\n"]}
+{"version":3,"file":"agent-events.js","sourceRoot":"","sources":["../src/agent-events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC1C,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,MAAM,UAAU,cAAc,CAAC,KAAyB;IACtD,MAAM,OAAO,GAAG,OAAO,WAAW,EAAE,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACzF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,GAAmB;IACpD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,cAAc,EAAE,mBAAmB;QACnC,eAAe,EAAE,wBAAwB;QACzC,UAAU,EAAE,YAAY;QACxB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1E,SAAS,CAAC,KAAK,EAAE,CAAC;IAElB,OAAO,GAAG,EAAE;QACV,aAAa,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,wBAAwB,CACtC,GAAoB,EACpB,GAAmB,EACnB,GAAQ;IAER,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,0BAA0B,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,aAAa,IAAI,IAAI,KAAK,UAAU,aAAa,EAAE,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;QACxF,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC,CAAC;QACpE,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAC/C,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { readEnv } from \"./env-manifest.js\";\nimport type { AgentEventEnvelope } from \"./types.js\";\n\nconst clients = new Set<ServerResponse>();\nlet nextEventId = 1;\n\nexport function emitAgentEvent(event: AgentEventEnvelope): void {\n  const payload = `id: ${nextEventId++}\\nevent: agent\\ndata: ${JSON.stringify(event)}\\n\\n`;\n  for (const client of clients) {\n    client.write(payload);\n  }\n}\n\nfunction addAgentEventStreamClient(res: ServerResponse): () => void {\n  clients.add(res);\n  res.writeHead(200, {\n    \"Content-Type\": \"text/event-stream\",\n    \"Cache-Control\": \"no-cache, no-transform\",\n    Connection: \"keep-alive\",\n    \"X-Accel-Buffering\": \"no\",\n  });\n  res.write(`: connected\\n\\n`);\n\n  const keepAlive = setInterval(() => res.write(`: keepalive\\n\\n`), 25_000);\n  keepAlive.unref();\n\n  return () => {\n    clearInterval(keepAlive);\n    clients.delete(res);\n    res.end();\n  };\n}\n\n/** The `/api/agent-events/stream` SSE endpoint (optionally token-gated). */\nexport function handleAgentEventsRequest(\n  req: IncomingMessage,\n  res: ServerResponse,\n  url: URL,\n): boolean {\n  if (req.method !== \"GET\" || url.pathname !== \"/api/agent-events/stream\") {\n    return false;\n  }\n\n  const expectedToken = readEnv(\"AGENT_EVENTS_TOKEN\");\n  const auth = req.headers.authorization ?? \"\";\n  const queryToken = url.searchParams.get(\"token\") ?? \"\";\n  if (expectedToken && auth !== `Bearer ${expectedToken}` && queryToken !== expectedToken) {\n    res.writeHead(401, { \"Content-Type\": \"text/plain; charset=utf-8\" });\n    res.end(\"unauthorized\");\n    return true;\n  }\n\n  const cleanup = addAgentEventStreamClient(res);\n  req.on(\"close\", cleanup);\n  return true;\n}\n"]}

package/dist/agent.d.ts

@@ -1,13 +1,18 @@
+/**
+ * Agent runner: prompt construction, path translation, run lifecycle, and createRunner.
+ * Single module — do not split helpers that only this file uses.
+ */
+export type { CreateRunnerOptions, PiAgentWrapper } from "./types.js";
+import type { CreateRunnerOptions, PiAgentWrapper } from "./types.js";
 import { type ImageContent } from "@earendil-works/pi-ai";
 import type { ConversationMessage } from "./adapter.js";
-import type { PlatformNotifier } from "./types.js";
-import type { SessionViewTokenStoreLike } from "./commands/types.js";
-import type { DockerContainerManager } from "./provisioner.js";
-import { type RuntimePathContext, type SandboxConfig } from "./sandbox/index.js";
-import type { VaultManager } from "./vault/index.js";
-import { type ResolvedSessionScope } from "./sessions/store.js";
-export type { PiAgentWrapper } from "./types.js";
-import type { PiAgentWrapper } from "./types.js";
+import { type RuntimePathContext } from "./sandbox/index.js";
+export declare function translateRuntimePathToHost(runtimePath: string, pathContext: RuntimePathContext): string;
+export declare function translateAttachPathToHost(filePath: string, pathContext: RuntimePathContext): string;
+export declare function buildPromptPayload(message: ConversationMessage, workspacePath: string, pathContext?: RuntimePathContext, readAttachment?: (runtimePath: string) => Promise<string>): Promise<{
+    userMessage: string;
+    imageAttachments: ImageContent[];
+}>;
 export declare function resolveTriggerAttribution(message: Pick<ConversationMessage, "id" | "text" | "userName">): string | undefined;
 /**
  * Instructions that vary per turn (event-trigger mode, response attribution).
@@ -17,11 +22,6 @@ export declare function resolveTriggerAttribution(message: Pick<ConversationMess
  * Returns an empty string when the turn needs no special framing.
  */
 export declare function buildTurnInstructions(isEventTrigger: boolean, triggerAttribution: string | undefined, platformName: string): string;
-export declare function getUnresolvedSandboxPathContext(sandboxConfig: SandboxConfig, hostWorkspaceRoot: string): RuntimePathContext;
-export declare function buildPromptPayload(message: ConversationMessage, workspacePath: string, pathContext?: RuntimePathContext): {
-    userMessage: string;
-    imageAttachments: ImageContent[];
-};
 export declare function appendTriggerAttribution(text: string, triggerAttribution: string | undefined, sessionLink?: string): string;
 /**
  * Create a new PiAgentWrapper for a channel.
@@ -30,10 +30,5 @@ export declare function appendTriggerAttribution(text: string, triggerAttributio
  * Runner caching is handled by the caller (channelStates in main.ts).
  * This is a stateless factory function.
  */
-export declare function createRunner(sandboxConfig: SandboxConfig, sessionKey: string, conversationId: string, conversationDir: string, workspaceDir: string, sessionScope: ResolvedSessionScope, vaultManager?: VaultManager, provisioner?: DockerContainerManager, sessionView?: {
-    tokenStore: SessionViewTokenStoreLike;
-    portalBaseUrl?: string;
-}, platformNotifier?: PlatformNotifier): Promise<PiAgentWrapper>;
-export declare function translateRuntimePathToHost(runtimePath: string, pathContext: RuntimePathContext): string;
-export declare function translateAttachPathToHost(filePath: string, pathContext: RuntimePathContext): string;
+export declare function createRunner(options: CreateRunnerOptions): Promise<PiAgentWrapper>;
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,YAAY,EAAc,MAAM,uBAAuB,CAAC;AAkBhF,OAAO,KAAK,EACV,mBAAmB,EAKpB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAiC,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAMrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAC;AAQ7B,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyIjD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC,GAC7D,MAAM,GAAG,SAAS,CAOpB;AA6KD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,OAAO,EACvB,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,MAAM,GACnB,MAAM,CAkBR;AAED,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,MAAM,GACxB,kBAAkB,CAMpB;AAwUD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,kBAAkB,GAC/B;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC,CAaA;AA+BD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR;AAmsBD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,oBAAoB,EAClC,YAAY,CAAC,EAAE,YAAY,EAC3B,WAAW,CAAC,EAAE,sBAAsB,EACpC,WAAW,CAAC,EAAE;IACZ,UAAU,EAAE,yBAAyB,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,EACD,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,cAAc,CAAC,CAyNzB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAKR"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAIrF,OAAO,EAAY,KAAK,YAAY,EAAc,MAAM,uBAAuB,CAAC;AA+BhF,OAAO,KAAK,EAEV,mBAAmB,EAKpB,MAAM,cAAc,CAAC;AAmBtB,OAAO,EAKL,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAiC5B,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAER;AAcD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CA2BR;AAgGD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,kBAAkB,EAChC,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACxD,OAAO,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC,CAAC,CAcD;AAwKD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC,GAC7D,MAAM,GAAG,SAAS,CAOpB;AAsMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,OAAO,EACvB,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,MAAM,GACnB,MAAM,CAkBR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR;AA02CD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiZxF"}