@agentchatme/agent-core 0.0.1311 → 0.0.1313

package/dist/daemon-entry.d.ts

@@ -7,8 +7,11 @@ declare const SyncRowSchema: z.ZodObject<{
     delivery_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sender: z.ZodOptional<z.ZodString>;
     sender_handle: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
     type: z.ZodOptional<z.ZodString>;
     content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    status: z.ZodOptional<z.ZodString>;
     created_at: z.ZodOptional<z.ZodString>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodString;
@@ -16,8 +19,11 @@ declare const SyncRowSchema: z.ZodObject<{
     delivery_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sender: z.ZodOptional<z.ZodString>;
     sender_handle: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
     type: z.ZodOptional<z.ZodString>;
     content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    status: z.ZodOptional<z.ZodString>;
     created_at: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodString;
@@ -25,8 +31,11 @@ declare const SyncRowSchema: z.ZodObject<{
     delivery_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sender: z.ZodOptional<z.ZodString>;
     sender_handle: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
     type: z.ZodOptional<z.ZodString>;
     content: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    status: z.ZodOptional<z.ZodString>;
     created_at: z.ZodOptional<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">>;
 type SyncRow = z.infer<typeof SyncRowSchema>;
@@ -47,8 +56,12 @@ declare class AgentWsClient extends EventEmitter {
     private attempt;
     private reconnectTimer;
     private livenessTimer;
+    private ackRetryTimer;
     private stopped;
     private ackMode;
+    private inboundPaused;
+    private readonly pendingAcks;
+    private readonly acksInFlight;
     constructor(url: string, apiKey: string);
     /** True only while the socket is live and ready. The heartbeat writer keys
      *  off this, so a reconnecting/terminal daemon lets its heartbeat go stale
@@ -56,6 +69,14 @@ declare class AgentWsClient extends EventEmitter {
     get connected(): boolean;
     start(): void;
     stop(): void;
+    /**
+     * Apply TCP backpressure while the model-turn queue is saturated. `ws`
+     * delegates this to the underlying socket; no delivered frame is discarded.
+     * A server heartbeat may close a very long pause, which is safe because all
+     * unacked messages re-drain after reconnect.
+     */
+    pauseInbound(): void;
+    resumeInbound(): void;
     getState(): State;
     /**
      * Confirm a message as handled: `{"type":"ack","message_id":"msg_..."}`.
@@ -65,6 +86,8 @@ declare class AgentWsClient extends EventEmitter {
      * real-time push — which carries no delivery_id — be acked at all.
      */
     ack(messageId: string): void;
+    private flushAcks;
+    private scheduleAckRetry;
     private open;
     private scheduleReconnect;
     private armLiveness;
@@ -91,9 +114,43 @@ declare class ReplyCoord {
      * → TRUE (reply anyway rather than drop).
      */
     claim(messageId: string): Promise<boolean>;
+    /**
+     * Claim the contiguous oldest-first prefix of one conversation batch.
+     * Falls back to ordered single-message claims against an older API server;
+     * all other coordination failures remain fail-open.
+     */
+    claimBatch(messageIds: string[]): Promise<number>;
 }
 
+interface TurnMentionContext {
+    messageId: string;
+    messageSeq?: number | undefined;
+    sender: string;
+    senderDisplayName?: string | null | undefined;
+    senderKind?: 'agent' | 'system' | undefined;
+    createdAt?: string | undefined;
+    replyToMessageId?: string | null | undefined;
+    /** Bounded notification preview. Full content comes from the anchored
+     * conversation read requested by the turn prompt. */
+    textPreview: string;
+}
+interface TurnBatchContext {
+    /** Number of durable deliveries represented by this one runtime turn. */
+    count: number;
+    /** Exact oldest-first delivery ids in the frozen batch. */
+    messageIds: string[];
+    oldestMessageId: string;
+    oldestMessageSeq?: number | undefined;
+    newestMessageId: string;
+    newestMessageSeq?: number | undefined;
+    /** Group messages in this batch that explicitly @mentioned this agent. */
+    mentionedMessages: TurnMentionContext[];
+}
 interface TurnContext {
+    /** Trusted server message id that caused this autonomous turn. */
+    messageId?: string | undefined;
+    /** Monotonic sequence number inside the AgentChat conversation. */
+    messageSeq?: number | undefined;
     /** The AgentChat conversation the message belongs to. */
     conversationId: string;
     /** @handle of the sender. */
@@ -114,10 +171,19 @@ interface TurnContext {
     senderKind?: 'agent' | 'system' | undefined;
     /** Group's human-readable name (null for DMs / when the server omitted it). */
     groupName?: string | null | undefined;
+    /** Current group size when the delivery carried it. */
+    memberCount?: number | null | undefined;
+    /** Sender-authored reply-parent id, when this message is a threaded reply. */
+    replyToMessageId?: string | null | undefined;
+    /** Recipient-scoped delivery/read state from the server envelope. */
+    deliveryStatus?: string | undefined;
     /** True when THIS agent's handle is in the server-parsed mention list. The
      *  daemon computes membership (it knows its own handle) so the adapter just
      *  renders the positive fact. */
     mentioned?: boolean | undefined;
+    /** Frozen same-conversation backlog represented by this turn. The ordinary
+     *  top-level message fields always describe its newest/focus message. */
+    pendingBatch?: TurnBatchContext | undefined;
 }
 interface TurnResult {
     ok: boolean;
@@ -127,6 +193,13 @@ interface TurnResult {
 }
 interface RuntimeAdapter {
     readonly name: string;
+    /**
+     * Reset conversation continuity when the authenticated AgentChat identity
+     * changes. `identityNamespace` contains no credential material; callers use
+     * the authenticated API base + handle. Adapters that persist host sessions
+     * must include it in their session key, not merely clear an in-memory map.
+     */
+    reset?(identityNamespace: string): void;
     /** Verify the runtime is usable (binary present, logged in). */
     preflight(): Promise<{
         ok: boolean;
@@ -143,6 +216,10 @@ declare function describeConversation(ctx: TurnContext): string;
 /** Resolved sender identity: "Display Name (@handle)" or "@handle", flagging a
  *  system agent so the model weights its words as platform-authored. */
 declare function describeSender(ctx: TurnContext): string;
+/** One canonical unattended-delivery prompt for every coding-agent host.
+ * Host adapters only decide how to launch/resume their runtime; AgentChat's
+ * message framing and agent-facing context contract must not drift. */
+declare function buildAgentChatTurnPrompt(ctx: TurnContext): string;
 
 interface RunDaemonOpts {
     /** THE identity home for the agent this daemon serves. */
@@ -186,6 +263,10 @@ interface ResolveDaemonOpts {
  */
 declare function resolveDaemonConfig(opts: ResolveDaemonOpts): Promise<DaemonConfig>;
 
+interface DaemonFailure {
+    kind: 'socket-auth' | 'runtime';
+    reason: string;
+}
 declare class Daemon {
     private readonly cfg;
     private readonly adapter;
@@ -195,7 +276,9 @@ declare class Daemon {
     private readonly ws;
     private readonly coord;
     private readonly seen;
-    private readonly convChains;
+    private readonly convQueues;
+    private readonly convWorkers;
+    private pending;
     private inFlight;
     private readonly waiters;
     private stopping;
@@ -203,15 +286,22 @@ declare class Daemon {
     constructor(cfg: DaemonConfig, adapter: RuntimeAdapter, ws?: AgentWsClient, // injectable for tests; defaults to a real socket
     /** Called when the socket gives up for good (auth refused). The supervisor
      *  above decides what happens next — this class does not end the process. */
-    onTerminal?: ((reason: string) => void) | undefined);
+    onTerminal?: ((failure: DaemonFailure) => void) | undefined);
     start(): Promise<void>;
     stop(): void;
     private onInbound;
-    /** Serialize turns within a conversation; the global semaphore caps total. */
-    private enqueue;
-    private handle;
+    /** Queue one already-tracked row and ensure exactly one worker for its conversation. */
+    private enqueueExisting;
+    /** Process bounded backlog snapshots, in arrival order within a conversation. */
+    private drainConversation;
+    private handleNextBatch;
+    private turnContext;
+    private markHandled;
+    private markNoLongerPending;
+    /** Bound reconnect-dedup memory without ever evicting unfinished work. */
+    private pruneSeen;
     private acquireSlot;
     private releaseSlot;
 }
 
-export { AgentWsClient, type CoordConfig, Daemon, type DaemonConfig, ReplyCoord, type ResolveDaemonOpts, type RunDaemonOpts, type RuntimeAdapter, type TurnContext, type TurnResult, type WsClientEvents, describeConversation, describeSender, parseInbound, resolveDaemonConfig, runDaemon, senderOf, wsUrlFor };
+export { AgentWsClient, type CoordConfig, Daemon, type DaemonConfig, ReplyCoord, type ResolveDaemonOpts, type RunDaemonOpts, type RuntimeAdapter, type TurnBatchContext, type TurnContext, type TurnMentionContext, type TurnResult, type WsClientEvents, buildAgentChatTurnPrompt, describeConversation, describeSender, parseInbound, resolveDaemonConfig, runDaemon, senderOf, wsUrlFor };