@agent-link/agent 0.1.338 → 0.1.339

package/dist/copilot-plan-state.js

@@ -0,0 +1,180 @@
+import { createHash, randomUUID } from 'crypto';
+import { existsSync, readFileSync, statSync } from 'fs';
+import { atomicWriteCopilotSidecar } from './copilot-sidecar.js';
+import { join, resolve, sep } from 'path';
+import { isCopilotChildEvent } from './copilot-event-scope.js';
+export const COPILOT_PLAN_STATE_FILE = '.agentlink-plan-state.json';
+const OPEN = '<agentlink_plan_control>';
+const CLOSE = '</agentlink_plan_control>';
+function statePath(root, sessionId) {
+    const base = resolve(root);
+    const session = resolve(base, sessionId);
+    if (session === base || !session.startsWith(base + sep))
+        throw new Error('Invalid Plan session');
+    return join(session, COPILOT_PLAN_STATE_FILE);
+}
+export function beginCopilotPlanState(root, sessionId) {
+    const path = statePath(root, sessionId);
+    const revision = randomUUID();
+    // Only existing Provider Session directories are writable; discovery never
+    // creates a directory as a side effect of this internal metadata mechanism.
+    if (existsSync(join(root, sessionId))) {
+        atomicWriteCopilotSidecar(path, JSON.stringify({ version: 1, revision, status: 'awaiting_input' }), 'utf8');
+    }
+    return revision;
+}
+export function readCopilotPlanState(root, sessionId, revision) {
+    try {
+        const value = JSON.parse(readFileSync(statePath(root, sessionId), 'utf8'));
+        return value.version === 1 && value.revision === revision
+            && (value.status === 'ready' || value.status === 'awaiting_input') ? value.status : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function readCopilotPlanRevision(root, sessionId) {
+    try {
+        const value = JSON.parse(readFileSync(statePath(root, sessionId), 'utf8'));
+        return value.version === 1 && typeof value.revision === 'string' && value.revision ? value.revision : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Recover only the latest completed main Plan, never a draft or a child artifact. */
+export function findRecoverableCopilotPlan(root, sessionId) {
+    try {
+        const declarationPath = statePath(root, sessionId);
+        const declaration = JSON.parse(readFileSync(declarationPath, 'utf8'));
+        if (declaration.version !== 1 || declaration.status !== 'ready'
+            || typeof declaration.revision !== 'string' || !declaration.revision)
+            return null;
+        const dir = join(root, sessionId);
+        const planPath = join(dir, 'plan.md');
+        const content = readFileSync(planPath, 'utf8').trim();
+        if (!content || stripCopilotPlanControl(content) !== content)
+            return null;
+        let mode = 'interactive';
+        let requestAt = NaN;
+        let exitSucceeded = false;
+        let failed = false;
+        let boundary;
+        const exitCalls = new Set();
+        for (const line of readFileSync(join(dir, 'events.jsonl'), 'utf8').split('\n')) {
+            if (!line.trim())
+                continue;
+            const event = JSON.parse(line);
+            if (isCopilotChildEvent(event))
+                continue;
+            const data = event.data || {};
+            if (event.type === 'user.message') {
+                // A later real request invalidates recovery, even if it has not ended.
+                requestAt = Date.parse(event.timestamp || '');
+                exitSucceeded = false;
+                failed = false;
+                boundary = undefined;
+                exitCalls.clear();
+            }
+            if (event.type === 'session.mode_changed')
+                mode = data.newMode;
+            if (mode === 'plan' && event.type === 'assistant.message') {
+                for (const tool of data.toolRequests || []) {
+                    if (tool.name === 'exit_plan_mode' && typeof tool.toolCallId === 'string' && tool.toolCallId)
+                        exitCalls.add(tool.toolCallId);
+                }
+            }
+            if (mode === 'plan' && event.type === 'tool.execution_start' && data.toolName === 'exit_plan_mode'
+                && typeof data.toolCallId === 'string' && data.toolCallId)
+                exitCalls.add(data.toolCallId);
+            if (event.type === 'tool.execution_complete' && exitCalls.has(data.toolCallId))
+                exitSucceeded = data.success === true;
+            if (event.type === 'abort' || event.type === 'session.error' || event.type === 'session.compaction_failed'
+                || (event.type === 'session.compaction_complete' && data.success === false))
+                failed = true;
+            if (exitSucceeded && event.type === 'assistant.turn_end' && typeof event.id === 'string') {
+                boundary = { id: event.id, at: Date.parse(event.timestamp || ''), turnId: data.turnId };
+            }
+        }
+        if (!boundary || failed || !exitSucceeded || !Number.isFinite(requestAt) || !Number.isFinite(boundary.at))
+            return null;
+        const writtenAt = statSync(planPath).mtimeMs;
+        const declaredAt = statSync(declarationPath).mtimeMs;
+        // The current file must belong to that user request and predate its finish.
+        // A later edited artifact or a leftover old file must never become ready.
+        const sealed = declaration.planHash === createHash('sha256').update(content).digest('hex');
+        if (writtenAt < requestAt || writtenAt > boundary.at
+            || (!sealed && (declaredAt < requestAt || declaredAt > boundary.at)))
+            return null;
+        return { content, revision: declaration.revision, boundaryEventId: boundary.id, ...(boundary.turnId ? { turnId: boundary.turnId } : {}) };
+    }
+    catch {
+        return null;
+    }
+}
+export function sealCopilotPlanState(root, sessionId, revision, plan, holdPlanMode = false) {
+    const path = statePath(root, sessionId);
+    if (!existsSync(join(root, sessionId)))
+        return;
+    atomicWriteCopilotSidecar(path, JSON.stringify({
+        version: 1, revision, status: 'ready', planHash: createHash('sha256').update(plan).digest('hex'),
+        ...(holdPlanMode ? { holdPlanMode: true } : {}),
+    }), 'utf8');
+}
+export function holdsRecoveredCopilotPlanMode(root, sessionId) {
+    try {
+        return JSON.parse(readFileSync(statePath(root, sessionId), 'utf8')).holdPlanMode === true;
+    }
+    catch {
+        return false;
+    }
+}
+export function clearRecoveredCopilotPlanMode(root, sessionId) {
+    if (!holdsRecoveredCopilotPlanMode(root, sessionId))
+        return;
+    const path = statePath(root, sessionId);
+    const value = JSON.parse(readFileSync(path, 'utf8'));
+    atomicWriteCopilotSidecar(path, JSON.stringify({ ...value, holdPlanMode: false }), 'utf8');
+}
+export function copilotPlanStateAllowsImplementation(root, sessionId, plan) {
+    const path = statePath(root, sessionId);
+    if (!existsSync(path))
+        return true; // Legacy Plan snapshots.
+    try {
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        const currentPlan = readFileSync(join(root, sessionId, 'plan.md'), 'utf8').trim();
+        return value.version === 1 && value.status === 'ready'
+            && currentPlan === plan.trim()
+            && value.planHash === createHash('sha256').update(plan).digest('hex');
+    }
+    catch {
+        return false;
+    }
+}
+export function copilotPlanControlPrompt(root, sessionId, revision, deferred = [], nativeUserInput = false) {
+    const interaction = nativeUserInput
+        ? 'The native ask_user tool is enabled in this SDK session. Whenever a decision requires the user answer, invoke ask_user with the question and concrete choices when applicable, and wait for its response before continuing this same Plan. Do not print a question or A/B choices as an ordinary assistant reply and pretend to be waiting: that does not open the inline interaction. Do not infer tool unavailability from earlier conversation text or past diagnostics. Asking through ask_user is a UI interaction, not reading or modifying project files. Do not duplicate native questions in an artifact confirmation section.'
+        : 'Collect unresolved immediate questions under ## Decisions needed in plan.md, one numbered question per item with indented bullet choices. AgentLink will collect those artifact questions and return the answers before planning continues.';
+    return `${OPEN}${JSON.stringify({
+        version: 1, kind: 'plan-readiness', revision,
+        statusFile: statePath(root, sessionId), deferred,
+        interaction: nativeUserInput ? 'native' : 'artifact',
+        instructions: `${interaction} Plan clarification may need multiple rounds. Answering one batch is not completion or implementation authorization. Re-evaluate all decisions after each answer. Preserve confirmed decisions and do not infer all enhancements from a broad choice. Write the full plan.md as plain Markdown without control tokens or status JSON. After updating plan.md, write the separate statusFile as {"version":1,"revision":"<the revision above>","status":"awaiting_input"} if decisions remain, otherwise status "ready". Deferred questions are not answered: move them to a final confirmation section and do not re-ask them. Do not implement or print this control envelope, its metadata, or the sidecar contents in your reply.`,
+    })}${CLOSE}`;
+}
+/** Strip only a well-formed, trailing AgentLink-owned control envelope. */
+export function stripCopilotPlanControl(text) {
+    const trimmed = text.trimEnd();
+    const start = trimmed.lastIndexOf(OPEN);
+    if (start < 0 || !trimmed.endsWith(CLOSE))
+        return text;
+    try {
+        const value = JSON.parse(trimmed.slice(start + OPEN.length, -CLOSE.length));
+        if (value.version === 1 && value.kind === 'plan-readiness' && typeof value.revision === 'string'
+            && /^[0-9a-f-]{36}$/i.test(value.revision))
+            return trimmed.slice(0, start).trimEnd();
+    }
+    catch { /* Ordinary user text/quoted examples are not control envelopes. */ }
+    return text;
+}
+//# sourceMappingURL=copilot-plan-state.js.map

package/dist/copilot-plan-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-plan-state.js","sourceRoot":"","sources":["../src/copilot-plan-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AACpE,MAAM,IAAI,GAAG,0BAA0B,CAAC;AACxC,MAAM,KAAK,GAAG,2BAA2B,CAAC;AAG1C,SAAS,SAAS,CAAC,IAAY,EAAE,SAAiB;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACjG,OAAO,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAAiB;IACnE,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,4EAA4E;IAC5E,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QACtC,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,SAAiB,EAAE,QAAgB;IACpF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;eACpD,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,SAAiB;IACrE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7G,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,SAAiB;IAGxE,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;QACtE,IAAI,WAAW,CAAC,OAAO,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,OAAO;eACxD,OAAO,WAAW,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QACtF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1E,IAAI,IAAI,GAAG,aAAa,CAAC;QACzB,IAAI,SAAS,GAAG,GAAG,CAAC;QACpB,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,QAAiE,CAAC;QACtE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,mBAAmB,CAAC,KAAK,CAAC;gBAAE,SAAS;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAClC,uEAAuE;gBACvE,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;gBAC9C,aAAa,GAAG,KAAK,CAAC;gBAAC,MAAM,GAAG,KAAK,CAAC;gBAAC,QAAQ,GAAG,SAAS,CAAC;gBAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACjF,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;gBAAE,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;YAC/D,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBAC1D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;oBAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU;wBAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC/H,CAAC;YACH,CAAC;YACD,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAgB;mBAC3F,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU;gBAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9F,IAAI,KAAK,CAAC,IAAI,KAAK,yBAAyB,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,aAAa,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;YACtH,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,2BAA2B;mBACnG,CAAC,KAAK,CAAC,IAAI,KAAK,6BAA6B,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC;gBAAE,MAAM,GAAG,IAAI,CAAC;YAC/F,IAAI,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;gBACzF,QAAQ,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1F,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACvH,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;QAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC;QACrD,4EAA4E;QAC5E,0EAA0E;QAC1E,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3F,IAAI,SAAS,GAAG,SAAS,IAAI,SAAS,GAAG,QAAQ,CAAC,EAAE;eAC7C,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,GAAG,SAAS,IAAI,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACtF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5I,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,SAAiB,EAAE,QAAgB,EAAE,IAAY,EAAE,YAAY,GAAG,KAAK;IACxH,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAAE,OAAO;IAC/C,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;QAC7C,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAChG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,EAAE,MAAM,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY,EAAE,SAAiB;IAC3E,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC;IAAC,CAAC;IAClG,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY,EAAE,SAAiB;IAC3E,IAAI,CAAC,6BAA6B,CAAC,IAAI,EAAE,SAAS,CAAC;QAAE,OAAO;IAC5D,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,IAAY,EAAE,SAAiB,EAAE,IAAY;IAChG,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,yBAAyB;IAC7D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClF,OAAO,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;eACjD,WAAW,KAAK,IAAI,CAAC,IAAI,EAAE;eAC3B,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,SAAiB,EAAE,QAAgB,EAAE,WAAqB,EAAE,EAAE,eAAe,GAAG,KAAK;IAC1I,MAAM,WAAW,GAAG,eAAe;QACjC,CAAC,CAAC,ymBAAymB;QAC3mB,CAAC,CAAC,6OAA6O,CAAC;IAClP,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ;QAC5C,UAAU,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,QAAQ;QAChD,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;QACpD,YAAY,EAAE,GAAG,WAAW,ssBAAssB;KACnuB,CAAC,GAAG,KAAK,EAAE,CAAC;AACf,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5E,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;eACzF,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC,CAAC,mEAAmE,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/copilot-request-dispatch.d.ts

@@ -0,0 +1,10 @@
+type CopilotSessionBinding = {
+    copilotSessionId?: string | null;
+    lastCopilotSessionId?: string | null;
+};
+export declare function resolveCopilotCommandResumeSessionId(requestedSessionId: unknown, conversation?: CopilotSessionBinding): string | undefined;
+export declare function dispatchCopilotRequest(scope: {
+    conversationId: string;
+    providerId?: string;
+}, execute: () => Promise<void>, send: (message: Record<string, unknown>) => void, hasActiveTurn: () => boolean): Promise<void>;
+export {};

package/dist/copilot-request-dispatch.js

@@ -0,0 +1,31 @@
+export function resolveCopilotCommandResumeSessionId(requestedSessionId, conversation) {
+    if (requestedSessionId !== undefined
+        && (typeof requestedSessionId !== 'string' || !requestedSessionId.trim())) {
+        throw new Error('Invalid Copilot resumeSessionId. Reopen the intended conversation before sending.');
+    }
+    const boundSessionId = conversation?.copilotSessionId || conversation?.lastCopilotSessionId || undefined;
+    if (boundSessionId && requestedSessionId && boundSessionId !== requestedSessionId) {
+        throw new Error('Copilot conversation/session mismatch. Reopen the intended conversation before sending.');
+    }
+    return requestedSessionId ?? boundSessionId;
+}
+// WebSocket listeners cannot catch a detached Promise rejection with their
+// synchronous try/catch. Reject this request without terminating the Agent or
+// treating another still-running turn as failed.
+export async function dispatchCopilotRequest(scope, execute, send, hasActiveTurn) {
+    let ownerWasActive = false;
+    try {
+        ownerWasActive = hasActiveTurn();
+        await execute();
+    }
+    catch (error) {
+        send({
+            type: 'error',
+            operation: 'copilot_request',
+            ...scope,
+            message: error instanceof Error ? error.message : String(error),
+            ...(ownerWasActive && hasActiveTurn() ? { preserveActiveTurn: true } : {}),
+        });
+    }
+}
+//# sourceMappingURL=copilot-request-dispatch.js.map

package/dist/copilot-request-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-request-dispatch.js","sourceRoot":"","sources":["../src/copilot-request-dispatch.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,oCAAoC,CAClD,kBAA2B,EAC3B,YAAoC;IAEpC,IAAI,kBAAkB,KAAK,SAAS;WAC/B,CAAC,OAAO,kBAAkB,KAAK,QAAQ,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,cAAc,GAAG,YAAY,EAAE,gBAAgB,IAAI,YAAY,EAAE,oBAAoB,IAAI,SAAS,CAAC;IACzG,IAAI,cAAc,IAAI,kBAAkB,IAAI,cAAc,KAAK,kBAAkB,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IACD,OAAQ,kBAAyC,IAAI,cAAc,CAAC;AACtE,CAAC;AAED,2EAA2E;AAC3E,8EAA8E;AAC9E,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAsD,EACtD,OAA4B,EAC5B,IAAgD,EAChD,aAA4B;IAE5B,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,CAAC;QACH,cAAc,GAAG,aAAa,EAAE,CAAC;QACjC,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,iBAAiB;YAC5B,GAAG,KAAK;YACR,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,GAAG,CAAC,cAAc,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/copilot-review-documents.d.ts

@@ -0,0 +1,17 @@
+/** Presentation-only snapshots from successful file tools; never read project files. */
+export interface CopilotReviewDocument {
+    path: string;
+    content: string;
+}
+/** Hide only tools whose actual targets are all internal; mixed patches stay visible. */
+export declare function copilotVisibleFileTool(tool: string, input: unknown): {
+    hidden: boolean;
+    input: unknown;
+};
+export declare function copilotVisibleFileToolOutput(content: string | undefined): string | undefined;
+export declare class CopilotReviewDocuments {
+    private pending;
+    private documents;
+    start(id: string, tool: string, input: unknown): void;
+    complete(id: string, success: boolean): CopilotReviewDocument[];
+}

package/dist/copilot-review-documents.js

@@ -0,0 +1,162 @@
+function normalizePath(path) {
+    return path.replace(/\\+/g, '/').toLowerCase();
+}
+function internalPlanPath(path) {
+    const normalized = normalizePath(path);
+    return normalized.includes('/.copilot/session-state/')
+        && /\/(?:plan\.md|\.agentlink-plan-state\.json)$/.test(normalized);
+}
+function patchText(input) {
+    if (typeof input === 'string')
+        return input;
+    if (!input || typeof input !== 'object')
+        return undefined;
+    const record = input;
+    return [record.patch, record.input].find(value => typeof value === 'string');
+}
+function patchFiles(text) {
+    const files = [];
+    for (const line of text.replace(/\r\n/g, '\n').split('\n')) {
+        const header = line.match(/^\*\*\* (Add|Update|Delete) File: (.+)$/);
+        if (header)
+            files.push({ path: header[2].trim(), operation: header[1], lines: [] });
+        else if (files.length && line !== '*** End Patch')
+            files[files.length - 1].lines.push(line);
+    }
+    return files;
+}
+/** Hide only tools whose actual targets are all internal; mixed patches stay visible. */
+export function copilotVisibleFileTool(tool, input) {
+    const text = patchText(input);
+    if (tool === 'apply_patch' && text) {
+        const files = patchFiles(text);
+        if (!files.length)
+            return { hidden: false, input };
+        const visible = files.filter(file => !internalPlanPath(file.path));
+        if (visible.length === files.length)
+            return { hidden: false, input };
+        if (!visible.length)
+            return { hidden: true, input: undefined };
+        const patch = ['*** Begin Patch', ...visible.flatMap(file => [
+                `*** ${file.operation} File: ${file.path}`, ...file.lines,
+            ]), '*** End Patch'].join('\n');
+        if (typeof input === 'string')
+            return { hidden: false, input: patch };
+        const record = input;
+        return { hidden: false, input: { ...record, [typeof record.patch === 'string' ? 'patch' : 'input']: patch } };
+    }
+    if (input && typeof input === 'object') {
+        const record = input;
+        const path = record.path || record.file_path || record.filePath;
+        if (typeof path === 'string' && internalPlanPath(path))
+            return { hidden: true, input: undefined };
+    }
+    return { hidden: false, input };
+}
+export function copilotVisibleFileToolOutput(content) {
+    return content?.split(/\r?\n/).filter(line => !internalPlanPath(line.trim())).join('\n');
+}
+/** Reconstruct update hunks only when the complete prior version is known. */
+function updateContent(previous, lines) {
+    if (previous === undefined || lines.some(line => line.startsWith('*** Move to:')))
+        return undefined;
+    let result = previous;
+    let cursor = 0;
+    const hunks = [];
+    for (const line of lines) {
+        if (line.startsWith('@@'))
+            hunks.push([]);
+        else if (/^[ +\-]/.test(line)) {
+            if (!hunks.length)
+                hunks.push([]);
+            hunks[hunks.length - 1].push(line);
+        }
+    }
+    for (const hunk of hunks) {
+        const before = hunk.filter(line => !line.startsWith('+')).map(line => line.slice(1)).join('\n');
+        const after = hunk.filter(line => !line.startsWith('-')).map(line => line.slice(1)).join('\n');
+        if (!before)
+            return undefined;
+        const index = result.indexOf(before, cursor);
+        if (index < 0 || result.indexOf(before, index + 1) >= 0)
+            return undefined;
+        result = result.slice(0, index) + after + result.slice(index + before.length);
+        cursor = index + after.length;
+    }
+    return hunks.length ? result : undefined;
+}
+export class CopilotReviewDocuments {
+    pending = new Map();
+    documents = new Map();
+    start(id, tool, input) {
+        if (input === undefined)
+            return;
+        if (!['apply_patch', 'write', 'edit', 'create'].includes(tool))
+            return;
+        if (this.pending.size >= 64)
+            this.pending.delete(this.pending.keys().next().value);
+        this.pending.set(id, { tool, input });
+    }
+    complete(id, success) {
+        const pending = this.pending.get(id);
+        this.pending.delete(id);
+        if (!pending)
+            return [];
+        if (!success) {
+            // A failed writer may have left partial data; later hunks cannot validate it.
+            const text = patchText(pending.input);
+            if (pending.tool === 'apply_patch' && text) {
+                for (const file of patchFiles(text))
+                    this.documents.delete(normalizePath(file.path));
+            }
+            else if (pending.input && typeof pending.input === 'object') {
+                const record = pending.input;
+                const path = record.path || record.file_path || record.filePath;
+                if (typeof path === 'string')
+                    this.documents.delete(normalizePath(path));
+            }
+            return [];
+        }
+        const written = new Map();
+        const save = (path, content) => {
+            const key = normalizePath(path);
+            this.documents.delete(key);
+            written.delete(key);
+            // Bounded snapshots. Missing/partial contents must not masquerade as a full document.
+            if (content !== undefined && content.length <= 128_000 && /\.md$/i.test(path) && !internalPlanPath(path)) {
+                const snapshot = { path, content };
+                this.documents.set(key, snapshot);
+                written.set(key, snapshot);
+                if (this.documents.size > 16)
+                    this.documents.delete(this.documents.keys().next().value);
+                if (written.size > 16)
+                    written.delete(written.keys().next().value);
+            }
+        };
+        const text = patchText(pending.input);
+        if (pending.tool === 'apply_patch' && text) {
+            for (const file of patchFiles(text)) {
+                if (internalPlanPath(file.path))
+                    continue;
+                const prior = this.documents.get(normalizePath(file.path))?.content;
+                const content = file.operation === 'Add'
+                    ? file.lines.filter(line => line.startsWith('+')).map(line => line.slice(1)).join('\n')
+                    : file.operation === 'Update' ? updateContent(prior, file.lines) : undefined;
+                save(file.path, content);
+            }
+        }
+        else if (pending.input && typeof pending.input === 'object') {
+            const record = pending.input;
+            const path = record.path || record.file_path || record.filePath;
+            if (typeof path !== 'string')
+                return [];
+            const content = record.content ?? record.file_text;
+            if (['write', 'create'].includes(pending.tool) && typeof content === 'string')
+                save(path, content);
+            else
+                save(path, undefined);
+        }
+        return [...written.values()];
+    }
+}
+//# sourceMappingURL=copilot-review-documents.js.map

package/dist/copilot-review-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-review-documents.js","sourceRoot":"","sources":["../src/copilot-review-documents.ts"],"names":[],"mappings":"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"}

package/dist/copilot-session-activity.d.ts

@@ -0,0 +1,3 @@
+/** Sorting is conversation activity, not Provider maintenance. Native journals
+ * remain untouched. Read only appended bytes after the first reconstruction. */
+export declare function copilotSessionActivity(path: string, fallback: number, createdAt?: number): number;

package/dist/copilot-session-activity.js

@@ -0,0 +1,94 @@
+import { closeSync, openSync, readSync, statSync } from 'fs';
+import { isCopilotChildEvent } from './copilot-event-scope.js';
+const cache = new Map();
+const activityTypes = new Set(['user.message', 'assistant.message', 'tool.execution_start',
+    'tool.execution_complete', 'session.task_complete']);
+/** Sorting is conversation activity, not Provider maintenance. Native journals
+ * remain untouched. Read only appended bytes after the first reconstruction. */
+export function copilotSessionActivity(path, fallback, createdAt) {
+    let fd;
+    try {
+        const stats = statSync(path);
+        let state = cache.get(path);
+        if (!state || stats.size < state.offset || stats.birthtimeMs !== state.birthtime
+            || (stats.size === state.offset && stats.mtimeMs !== state.mtime)) {
+            state = { offset: 0, partial: Buffer.alloc(0), mtime: 0, birthtime: stats.birthtimeMs,
+                compacting: false, hasCompaction: false };
+        }
+        if (stats.size > state.offset) {
+            fd = openSync(path, 'r');
+            const chunk = Buffer.alloc(64 * 1024);
+            while (state.offset < stats.size) {
+                const read = readSync(fd, chunk, 0, Math.min(chunk.length, stats.size - state.offset), state.offset);
+                if (!read)
+                    break;
+                state.offset += read;
+                const bytes = Buffer.concat([state.partial, chunk.subarray(0, read)]);
+                let start = 0;
+                for (let end = bytes.indexOf(10); end >= 0; end = bytes.indexOf(10, start)) {
+                    const line = bytes.subarray(start, end).toString('utf8');
+                    start = end + 1;
+                    try {
+                        const event = JSON.parse(line);
+                        const child = isCopilotChildEvent(event);
+                        const type = event.type;
+                        if (type === 'session.compaction_start') {
+                            state.hasCompaction = true;
+                            if (!child)
+                                state.compacting = true;
+                            continue;
+                        }
+                        if (type === 'session.compaction_complete' || type === 'session.compaction_failed') {
+                            state.hasCompaction = true;
+                            if (!child)
+                                state.compacting = false;
+                            continue;
+                        }
+                        // A new real request also bounds an abandoned compression after restart.
+                        const data = event.data || {};
+                        if (child || (typeof data.source === 'string' && data.source.startsWith('agent-')))
+                            continue;
+                        if (type === 'user.message') {
+                            if (/^\s*\/compact(?:\s|$)/i.test(data.content || ''))
+                                continue;
+                            state.compacting = false;
+                        }
+                        if (type === 'abort') {
+                            state.compacting = false;
+                            continue;
+                        }
+                        // A native background compactor can overlap the real final answer.
+                        // That explicitly identified answer is activity, not maintenance.
+                        if ((state.compacting && !(type === 'assistant.message' && data.phase === 'final_answer'))
+                            || !activityTypes.has(type))
+                            continue;
+                        const at = Date.parse(event.timestamp || '');
+                        if (Number.isFinite(at))
+                            state.lastActivity = Math.max(state.lastActivity ?? 0, at);
+                    }
+                    catch { /* Ignore incomplete/legacy native records, never rewrite them. */ }
+                }
+                state.partial = Buffer.from(bytes.subarray(start));
+            }
+        }
+        state.mtime = stats.mtimeMs;
+        state.lastSort = state.hasCompaction
+            ? state.lastActivity ?? createdAt ?? fallback
+            : Math.max(state.lastActivity ?? 0, fallback);
+        cache.delete(path);
+        cache.set(path, state);
+        if (cache.size > 256)
+            cache.delete(cache.keys().next().value);
+        return state.lastSort;
+    }
+    catch {
+        // A Provider flush/temporary lock must not replace confirmed conversation
+        // activity with the newer maintenance timestamp.
+        return cache.get(path)?.lastSort ?? fallback;
+    }
+    finally {
+        if (fd != null)
+            closeSync(fd);
+    }
+}
+//# sourceMappingURL=copilot-session-activity.js.map

package/dist/copilot-session-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-session-activity.js","sourceRoot":"","sources":["../src/copilot-session-activity.ts"],"names":[],"mappings":"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"}

package/dist/copilot-sidecar.d.ts

@@ -0,0 +1,2 @@
+/** Publish one complete sidecar without truncating the previous snapshot. */
+export declare function atomicWriteCopilotSidecar(path: string, content: string, encoding?: BufferEncoding): void;

package/dist/copilot-sidecar.js

@@ -0,0 +1,17 @@
+import { renameSync, unlinkSync, writeFileSync } from 'fs';
+import { randomUUID } from 'crypto';
+/** Publish one complete sidecar without truncating the previous snapshot. */
+export function atomicWriteCopilotSidecar(path, content, encoding = 'utf8') {
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        writeFileSync(temporary, content, { encoding, flag: 'wx', mode: 0o600 });
+        renameSync(temporary, path);
+    }
+    finally {
+        try {
+            unlinkSync(temporary);
+        }
+        catch { /* Renamed successfully, or never created. */ }
+    }
+}
+//# sourceMappingURL=copilot-sidecar.js.map

package/dist/copilot-sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-sidecar.js","sourceRoot":"","sources":["../src/copilot-sidecar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,OAAe,EAAE,WAA2B,MAAM;IACxG,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAChD,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,6CAA6C,CAAC,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/copilot-turn-journal.d.ts

@@ -0,0 +1,36 @@
+type NativeEvent = {
+    id?: string;
+    type?: string;
+    timestamp?: string;
+    agentId?: string;
+    parentToolCallId?: string;
+    data?: Record<string, any>;
+};
+/** Request-scoped, read-only reconciliation of the Provider's own event journal. */
+export declare class CopilotTurnJournal {
+    private path;
+    private onEvent;
+    private offset;
+    private partial;
+    private seen;
+    private tasks;
+    private completedTasks;
+    private childRuns;
+    private childWrites;
+    private continuation;
+    private currentTurn;
+    private finalTurn;
+    private finalEnded;
+    private finalCheckpoint;
+    private compacting;
+    private pendingInputs;
+    complete: boolean;
+    constructor(path: string, onEvent: (event: NativeEvent) => void);
+    get pending(): boolean;
+    private get childrenPending();
+    private observeChildRuns;
+    private resetFinal;
+    read(): void;
+    observe(event: NativeEvent): void;
+}
+export {};