newmark-agent 0.5.14 → 0.5.15

package/dist/core/conversationCommandState.js

@@ -0,0 +1,140 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationCommandStateStore = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const modes = new Set(['build', 'plan', 'chat', 'goal', 'flow']);
+function stateValue(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('Invalid conversation command state');
+    const row = value;
+    const result = {};
+    if (row.mode !== undefined) {
+        if (typeof row.mode !== 'string' || !modes.has(row.mode))
+            throw new Error('Invalid conversation mode');
+        result.mode = row.mode;
+    }
+    if (row.inputMode !== undefined) {
+        if (row.inputMode !== 'guide' && row.inputMode !== 'next')
+            throw new Error('Invalid conversation input mode');
+        result.inputMode = row.inputMode;
+    }
+    if (row.queuePaused !== undefined) {
+        if (typeof row.queuePaused !== 'boolean')
+            throw new Error('Invalid conversation queue pause state');
+        result.queuePaused = row.queuePaused;
+    }
+    return result;
+}
+/** GUI command owner only; execution and continuation payloads remain owned by their Agent. */
+class ConversationCommandStateStore {
+    file;
+    records = new Map();
+    constructor(root) {
+        this.file = path.join(path.resolve(root), 'conversation-command-state.json');
+        let source;
+        try {
+            source = fs.readFileSync(this.file, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        const saved = JSON.parse(source);
+        if (saved?.version !== 1 || !saved.targets || typeof saved.targets !== 'object' || Array.isArray(saved.targets)) {
+            throw new Error('Unsupported conversation command state file');
+        }
+        for (const [key, value] of Object.entries(saved.targets))
+            this.records.set(this.key(key), stateValue(value));
+    }
+    get(key) {
+        const value = this.records.get(this.key(key));
+        return value ? { ...value } : undefined;
+    }
+    set(key, patch) {
+        const target = this.key(key);
+        const before = this.records.get(target);
+        const after = { ...before, ...stateValue(patch) };
+        if (before && before.mode === after.mode && before.inputMode === after.inputMode && before.queuePaused === after.queuePaused)
+            return { ...before };
+        const next = new Map(this.records);
+        next.set(target, after);
+        this.persist(next);
+        return { ...after };
+    }
+    delete(key) {
+        const target = this.key(key);
+        if (!this.records.has(target))
+            return;
+        const next = new Map(this.records);
+        next.delete(target);
+        this.persist(next);
+    }
+    key(value) {
+        if (typeof value !== 'string' || !value.trim())
+            throw new Error('Conversation target key is required');
+        return value;
+    }
+    persist(next) {
+        fs.mkdirSync(path.dirname(this.file), { recursive: true });
+        const temp = this.file + '.' + (0, node_crypto_1.randomUUID)() + '.tmp';
+        let descriptor;
+        try {
+            descriptor = fs.openSync(temp, 'wx', 0o600);
+            fs.writeFileSync(descriptor, JSON.stringify({ version: 1, targets: Object.fromEntries(next) }) + '\n');
+            fs.fsyncSync(descriptor);
+            fs.closeSync(descriptor);
+            descriptor = undefined;
+            fs.renameSync(temp, this.file);
+            this.records = next;
+        }
+        finally {
+            if (descriptor !== undefined)
+                fs.closeSync(descriptor);
+            try {
+                fs.unlinkSync(temp);
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+        }
+    }
+}
+exports.ConversationCommandStateStore = ConversationCommandStateStore;
+//# sourceMappingURL=conversationCommandState.js.map

package/dist/core/conversationKernel.d.ts

@@ -11,8 +11,9 @@ export interface ConversationQueueItemSnapshot {
     goalObjective?: string;
     runId?: string;
     createdAt: string;
+    images?: AgentPromptMessage['images'];
 }
-export type ConversationQueueAction = 'enqueue' | 'update' | 'delete' | 'reorder' | 'toggle_pause' | 'guide';
+export type ConversationQueueAction = 'enqueue' | 'update' | 'delete' | 'reorder' | 'toggle_pause' | 'set_pause' | 'guide';
 export interface ConversationQueueActionInput {
     id?: string;
     text?: string;
@@ -21,6 +22,7 @@ export interface ConversationQueueActionInput {
     createdAt?: string;
     images?: AgentPromptMessage['images'];
     orderedIds?: string[];
+    paused?: boolean;
 }
 export interface AgentPromptMessage {
     text: string;
@@ -38,6 +40,9 @@ export interface AgentPromptMessage {
     }>;
     attachments?: ConversationImageAttachment[];
     clientMessageId?: string;
+    /** Stable ordinary user identity; unlike clientMessageId alone, never denotes a Guide. */
+    userMessageId?: string;
+    createdAt?: string;
     guideId?: string;
     runId?: string;
     /**
@@ -189,7 +194,19 @@ export declare class ConversationKernel {
     constructor(root: string, host: Agent, automation: AutomationManager | null, lifecycle?: ConversationKernelLifecycle);
     subscribe(listener: WorkListener): () => void;
     isRunning(target: ConversationTargetInput): boolean;
+    conversationOwner(target: ConversationTargetInput): Agent | null;
+    /** Branch mutations retain the Agent but reload that branch's durable queue. */
+    refreshIdleConversation(target: ConversationTargetInput): void;
+    /** Detach idle owners before config replacement or workspace removal. */
+    disposeIdle(workspaceKey?: string): string[];
+    /** A Flow and its queue share one Agent; no second history writer is created. */
+    beginExternalRun(targetInput: ConversationTargetInput, options: ConversationKernelRunOptions, createOwner: () => Agent, previousQueuePaused?: boolean): Agent;
+    settleExternalRun(target: ConversationTargetInput, completed: boolean): void;
+    releaseExternalRun(target: ConversationTargetInput, paused: boolean): void;
+    prepareForArchive(target: ConversationTargetInput): Promise<Agent | null>;
+    finishArchive(target: ConversationTargetInput, completed: boolean, preserveOwner?: boolean): void;
     isAnyRunning(): boolean;
+    hasRetainedWork(): boolean;
     flushPersistence(): void;
     queued(target: ConversationTargetInput): {
         steering: string[];
@@ -216,7 +233,7 @@ export declare class ConversationKernel {
         createdAt?: string;
         images?: AgentPromptMessage['images'];
     }): ConversationQueueItemSnapshot;
-    updateQueueItem(target: ConversationTargetInput, idInput: string, textInput: string): ConversationQueueItemSnapshot;
+    updateQueueItem(target: ConversationTargetInput, idInput: string, textInput: string, input?: ConversationQueueActionInput): ConversationQueueItemSnapshot;
     deleteQueueItem(target: ConversationTargetInput, idInput: string): boolean;
     reorderQueueItems(target: ConversationTargetInput, orderedIdsInput: string[]): ConversationQueueItemSnapshot[];
     setQueuePaused(target: ConversationTargetInput, paused: boolean): boolean;
@@ -233,7 +250,10 @@ export declare class ConversationKernel {
     events(target: ConversationTargetInput): AgentWorkEvent[];
     waitForIdle(target: ConversationTargetInput): Promise<void>;
     pendingOptions(target: ConversationTargetInput): OptionQuestion[] | undefined;
-    snapshot(target: ConversationTargetInput): ReturnType<Agent['getConversationSnapshot']> & {
+    snapshot(target: ConversationTargetInput, options?: {
+        window?: number;
+        before?: number;
+    }): ReturnType<Agent['getConversationSnapshot']> & {
         target: NormalizedConversationTarget;
         queued: {
             steering: string[];
@@ -277,6 +297,7 @@ export declare class ConversationKernel {
     setMode(target: ConversationTargetInput, mode: AgentMode): AgentMode;
     setModel(target: ConversationTargetInput, model: string): string;
     toggleGoalPause(target: ConversationTargetInput): Promise<boolean>;
+    updateGoal(target: ConversationTargetInput, objective: string): ReturnType<Agent['getConversationSnapshot']>['goal'];
     clearGoal(target: ConversationTargetInput): boolean;
     updateSetting(section: string, key: string, value: unknown): void;
     runtimeState(target: ConversationTargetInput): ConversationRuntimeState | null;
@@ -304,6 +325,7 @@ export declare class ConversationKernel {
     private runtime;
     private scheduleGoalContinuation;
     private schedulePendingRuntimeContinuation;
+    private runPendingQueueItem;
     private startGoalDrivenBuild;
     private createRunner;
     private enqueueRootInboxWake;
@@ -320,7 +342,6 @@ export declare class ConversationKernel {
     private enqueueSameSession;
     private trackQueuedMessage;
     private consumeQueuedMessage;
-    private replaceTrackedQueuedMessage;
     private emitQueueUpdate;
     private clearQueued;
     private queueState;