@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/tools/unified/actions.js

@@ -0,0 +1,26 @@
+import { handleFileAccessTrack } from "./handlers/file-access-track.js";
+import { handleFileAccessList } from "./handlers/file-access-list.js";
+import { handleContextSummary } from "./handlers/context-summary.js";
+import { handleHookGenerator } from "./handlers/hook-generator.js";
+import { handleInstall } from "./install/handler.js";
+import { handleHookCall } from "./handlers/hook-call.js";
+import { handleSignalSend, handleSignalInbox } from "./handlers/signal.js";
+import { ContextSummaryInputSchema, FileAccessListInputSchema, FileAccessTrackInputSchema, HookCallActionInputSchema, HookGeneratorInputSchema, InstallInputSchema, SignalInboxInputSchema, SignalSendInputSchema } from "./schemas.js";
+import { parseExternalActionInput } from "./action-input.js";
+function action(schema, handler) {
+    return {
+        async execute(input, runtime, context) {
+            const parsed = parseExternalActionInput(schema, input);
+            return handler(runtime, parsed, context);
+        }
+    };
+}
+export const fileAccessTrackAction = action(FileAccessTrackInputSchema, (runtime, input) => handleFileAccessTrack(runtime, input));
+export const fileAccessListAction = action(FileAccessListInputSchema, (runtime, input) => handleFileAccessList(runtime, input));
+export const contextSummaryAction = action(ContextSummaryInputSchema, (runtime, input) => handleContextSummary(runtime, input));
+export const hookGeneratorAction = action(HookGeneratorInputSchema, (runtime, input) => handleHookGenerator(runtime, input));
+export const installAction = action(InstallInputSchema, (runtime, input) => handleInstall(runtime, input));
+export const hookCallAction = action(HookCallActionInputSchema, (runtime, input, context) => handleHookCall(runtime, input, context));
+export const signalSendAction = action(SignalSendInputSchema, (runtime, input) => handleSignalSend(runtime, input));
+export const signalInboxAction = action(SignalInboxInputSchema, (runtime, input) => handleSignalInbox(runtime, input));
+//# sourceMappingURL=actions.js.map

package/dist/tools/unified/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/tools/unified/actions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EACN,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAM7D,SAAS,MAAM,CACd,MAAe,EACf,OAI4B;IAE5B,OAAO;QACN,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO;YACpC,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACvD,OAAO,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAC1C,0BAA0B,EAC1B,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CACzD,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CACzC,yBAAyB,EACzB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CACxD,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CACzC,yBAAyB,EACzB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CACxD,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CACxC,wBAAwB,EACxB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACvD,CAAC;AACF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAClC,kBAAkB,EAClB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CACjD,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CACnC,yBAAyB,EACzB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CACpE,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CACrC,qBAAqB,EACrB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CACpD,CAAC;AACF,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CACtC,sBAAsB,EACtB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CACrD,CAAC"}

package/dist/tools/unified/external.descriptor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * External Tool Descriptor
+ *
+ * Metadata for the external tool. Safe to import anywhere.
+ */
+declare const _default: {
+    readonly kind: "tools/tool";
+    readonly id: "external";
+    readonly name: "External Integration";
+    readonly description: "Runtime-discovered external integration actions.";
+    readonly mcpDescription: "Editor and agent integrations. Ex: {action:\"context-summary\"}.";
+    readonly category: "integration";
+    readonly hardware: ["consumer"];
+    readonly purpose: ["direct", "worker", "mcp"];
+    readonly tags: ["external", "integration", "hooks", "context", "file-access"];
+    readonly safety: "write";
+    readonly requiresApproval: true;
+    readonly permissions: ["canAccessFilesystem"];
+    readonly schemas: {
+        readonly input: import("zod").ZodObject<{
+            action: import("zod").ZodString;
+        }, import("zod/v4/core").$loose>;
+        readonly output: import("zod").ZodObject<{
+            message: import("zod").ZodString;
+            data: import("zod").ZodOptional<import("zod").ZodUnknown>;
+        }, import("zod/v4/core").$strip>;
+    };
+};
+export default _default;
+//# sourceMappingURL=external.descriptor.d.ts.map

package/dist/tools/unified/external.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.descriptor.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/external.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;AAKH,wBAkBG"}

package/dist/tools/unified/external.descriptor.js

@@ -0,0 +1,27 @@
+/**
+ * External Tool Descriptor
+ *
+ * Metadata for the external tool. Safe to import anywhere.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel/factory';
+import { ExternalInputSchema, ExternalOutputSchema } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'tools/tool',
+    id: 'external',
+    name: 'External Integration',
+    description: 'Runtime-discovered external integration actions.',
+    mcpDescription: 'Editor and agent integrations. Ex: {action:"context-summary"}.',
+    category: 'integration',
+    hardware: ['consumer'],
+    purpose: ['direct', 'worker', 'mcp'],
+    tags: ['external', 'integration', 'hooks', 'context', 'file-access'],
+    safety: 'write',
+    // Can install hooks / track file access on the host — gate under auto-approve-safe.
+    requiresApproval: true,
+    permissions: ['canAccessFilesystem'],
+    schemas: {
+        input: ExternalInputSchema,
+        output: ExternalOutputSchema
+    }
+});
+//# sourceMappingURL=external.descriptor.js.map

package/dist/tools/unified/external.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.descriptor.js","sourceRoot":"","sources":["../../../src/tools/unified/external.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzE,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,kDAAkD;IAC/D,cAAc,EAAE,gEAAgE;IAChF,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;IACpC,IAAI,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC;IACpE,MAAM,EAAE,OAAO;IACf,oFAAoF;IACpF,gBAAgB,EAAE,IAAI;IACtB,WAAW,EAAE,CAAC,qBAAqB,CAAC;IACpC,OAAO,EAAE;QACR,KAAK,EAAE,mBAAmB;QAC1B,MAAM,EAAE,oBAAoB;KAC5B;CACD,CAAC,CAAC"}

package/dist/tools/unified/external.impl.consumer.d.ts

@@ -0,0 +1,8 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolCallContext } from '@vibesdotdev/kernel/schemas/tool-call';
+import { type ExternalInput, type ExternalOutput } from './schemas.ts';
+declare const _default: {
+    execute(input: ExternalInput, runtime: VibesRuntime, ctx: ToolCallContext): Promise<ExternalOutput>;
+};
+export default _default;
+//# sourceMappingURL=external.impl.consumer.d.ts.map

package/dist/tools/unified/external.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.impl.consumer.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/external.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAA6C,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;;mBAMzG,aAAa,WACX,YAAY,OAChB,eAAe,GAClB,OAAO,CAAC,cAAc,CAAC;;AAL3B,wBAmCE"}

package/dist/tools/unified/external.impl.consumer.js

@@ -0,0 +1,38 @@
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { ExternalInputSchema, ExternalOutputSchema } from "./schemas.js";
+import { parseExternalActionInput } from "./action-input.js";
+import { EXTERNAL_ACTION_KIND } from "./runtime.js";
+export default {
+    async execute(input, runtime, ctx) {
+        const admitted = parseExternalActionInput(ExternalInputSchema, input);
+        const actionId = admitted.action;
+        const descriptor = runtime.query(EXTERNAL_ACTION_KIND).withId(actionId).descriptors()[0];
+        if (!descriptor) {
+            const available = runtime
+                .query(EXTERNAL_ACTION_KIND)
+                .enabled()
+                .descriptors()
+                .map((candidate) => candidate.id)
+                .sort()
+                .join(', ');
+            throw new CapabilityError('The requested external action is not registered.', 'NOT_FOUND', {
+                reason: 'external-action-not-found',
+                recoveryHint: available ? `Available actions: ${available}` : undefined
+            });
+        }
+        const implementation = await runtime
+            .query(EXTERNAL_ACTION_KIND)
+            .withId(actionId)
+            .resolve();
+        const result = await implementation.execute(admitted, runtime, ctx);
+        try {
+            return ExternalOutputSchema.parse(result);
+        }
+        catch (error) {
+            throw new CapabilityError('The external action returned an invalid result.', 'INTERNAL', {
+                reason: 'external-action-output-invalid', cause: CaughtFailureSchema.parse(error)
+            });
+        }
+    }
+};
+//# sourceMappingURL=external.impl.consumer.js.map

package/dist/tools/unified/external.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.impl.consumer.js","sourceRoot":"","sources":["../../../src/tools/unified/external.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAqB,MAAM,qBAAqB,CAAC;AAE9F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAA2C,MAAM,cAAc,CAAC;AAClH,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAoE,MAAM,cAAc,CAAC;AAEtH,eAAe;IACd,KAAK,CAAC,OAAO,CACZ,KAAoB,EACpB,OAAqB,EACrB,GAAoB;QAEpB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,UAAU,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,OAAO;iBACvB,KAAK,CAAC,oBAAoB,CAAC;iBAC3B,OAAO,EAAE;iBACT,WAAW,EAAE;iBACb,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;iBAChC,IAAI,EAAE;iBACN,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,IAAI,eAAe,CAAC,kDAAkD,EAAE,WAAW,EAAE;gBAC1F,MAAM,EAAE,2BAA2B;gBACnC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;aACvE,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAAG,MAAM,OAAO;aAClC,KAAK,CAAyD,oBAAoB,CAAC;aACnF,MAAM,CAAC,QAAQ,CAAC;aAChB,OAAO,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC;YACJ,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CAAC,iDAAiD,EAAE,UAAU,EAAE;gBACxF,MAAM,EAAE,gCAAgC,EAAE,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC;aACjF,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;CACD,CAAC"}

package/dist/tools/unified/handlers/context-summary.d.ts

@@ -0,0 +1,4 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ContextSummaryInput, ExternalOutput } from '../schemas.ts';
+export declare function handleContextSummary(runtime: VibesRuntime, input: ContextSummaryInput): Promise<ExternalOutput>;
+//# sourceMappingURL=context-summary.d.ts.map

package/dist/tools/unified/handlers/context-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-summary.d.ts","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/context-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAkBzE,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,mBAAmB,GACxB,OAAO,CAAC,cAAc,CAAC,CAiEzB"}

package/dist/tools/unified/handlers/context-summary.js

@@ -0,0 +1,271 @@
+import { attempt } from "../../../ambient/attempt.js";
+import { ExternalClient } from "../../../client/external-client.js";
+import { resolveExternalSessionId, resolveExternalSessionManager } from "../../../session-capability.js";
+export async function handleContextSummary(runtime, input) {
+    const sessionId = input.sessionId ?? (await resolveExternalSessionId(runtime));
+    if (!sessionId) {
+        throw new Error('No active session found. Use session-init to create a new session, or provide sessionId explicitly.');
+    }
+    const startTime = Date.now();
+    const external = new ExternalClient(undefined, undefined, runtime);
+    const sessionManager = await resolveExternalSessionManager(runtime);
+    const fileContext = await gatherFileContext(external, sessionId, input);
+    const taskContext = await gatherTaskContext(runtime, sessionManager, sessionId, input);
+    const knowledgeContext = await gatherKnowledgeContext(runtime, sessionManager, sessionId, input);
+    const codeContext = input.includeCodeContext ? await gatherCodeContext() : undefined;
+    const preservationInstructions = generatePreservationInstructions(fileContext, taskContext, knowledgeContext, codeContext, input.customInstructions);
+    const sessionInfo = await getSessionInfo(runtime, sessionManager, sessionId);
+    const generationTimeMs = Date.now() - startTime;
+    const summary = {
+        version: '1.0',
+        generatedAt: new Date().toISOString(),
+        sessionId,
+        sessionTitle: sessionInfo?.title,
+        fileContext,
+        taskContext,
+        knowledgeContext,
+        codeContext,
+        preservationInstructions,
+        metadata: {
+            totalFilesTracked: fileContext.recentlyEdited.length + fileContext.recentlyRead.length,
+            totalTodos: taskContext.inProgress.length +
+                taskContext.pending.length +
+                taskContext.recentlyCompleted.length,
+            totalScratchpadEntries: knowledgeContext.totalEntries,
+            generationTimeMs
+        }
+    };
+    const formatted = formatSummary(summary, input.format);
+    const stats = {
+        totalFiles: fileContext.recentlyEdited.length + fileContext.recentlyRead.length,
+        totalTodos: taskContext.inProgress.length + taskContext.pending.length,
+        totalScratchpadEntries: knowledgeContext.totalEntries,
+        totalKnowledgeItems: 0,
+        totalSymbols: codeContext?.recentSymbols.length ?? 0,
+        generationTimeMs
+    };
+    return {
+        message: `Generated context summary with ${stats.totalFiles} files, ${stats.totalTodos} todos, ${stats.totalScratchpadEntries} notes`,
+        data: { summary, formatted, stats }
+    };
+}
+async function gatherFileContext(external, sessionId, input) {
+    const stats = await external.fileAccessStats(sessionId, input.maxFiles);
+    const recentlyEdited = stats
+        .filter((s) => s.editCount > 0 || s.writeCount > 0)
+        .slice(0, input.maxFiles);
+    const recentlyRead = stats
+        .filter((s) => s.readCount > 0)
+        .slice(0, input.maxFiles);
+    const hotspots = stats
+        .sort((a, b) => b.relevanceScore - a.relevanceScore)
+        .slice(0, 5)
+        .map((s) => ({
+        path: s.filePath,
+        score: s.relevanceScore,
+        reason: getHotspotReason(s)
+    }));
+    return { recentlyEdited, recentlyRead, hotspots };
+}
+function getHotspotReason(stats) {
+    const reasons = [];
+    if (stats.editCount > 0)
+        reasons.push(`${stats.editCount} edit(s)`);
+    if (stats.writeCount > 0)
+        reasons.push(`${stats.writeCount} write(s)`);
+    if (stats.readCount > 0)
+        reasons.push(`${stats.readCount} read(s)`);
+    return reasons.join(', ') || 'Frequently accessed';
+}
+async function gatherTaskContext(runtime, sessionManager, sessionId, input) {
+    if (!input.includeTodos) {
+        return { inProgress: [], pending: [], recentlyCompleted: [], summary: 'Todos not included' };
+    }
+    const outcome = await attempt(runtime, () => fetchTaskContext(sessionManager, sessionId), 'context-summary todos');
+    if (outcome.ok)
+        return outcome.value;
+    return { inProgress: [], pending: [], recentlyCompleted: [], summary: 'Unable to fetch todos' };
+}
+async function fetchTaskContext(sessionManager, sessionId) {
+    if (!sessionManager)
+        throw new Error('session/manager context is unavailable');
+    const todos = await sessionManager.listTodos(sessionId, { limit: 100, offset: 0 });
+    const inProgress = todos
+        .filter((todo) => todo.status === 'in_progress')
+        .map((todo) => ({
+        id: todo.id,
+        content: todo.content,
+        activeForm: todo.activeForm || todo.content,
+        priority: todo.priority ?? 'none'
+    }));
+    const pending = todos
+        .filter((todo) => todo.status === 'pending')
+        .map((todo) => ({ id: todo.id, content: todo.content, priority: todo.priority ?? 'none' }));
+    const recentlyCompleted = todos
+        .filter((todo) => todo.status === 'completed')
+        .slice(0, 10)
+        .map((todo) => ({
+        id: todo.id,
+        content: todo.content,
+        completedAt: todo.completedAt?.toISOString() ?? new Date().toISOString()
+    }));
+    return {
+        inProgress,
+        pending,
+        recentlyCompleted,
+        summary: generateTaskSummary(inProgress, pending, recentlyCompleted)
+    };
+}
+function generateTaskSummary(inProgress, pending, completed) {
+    const parts = [];
+    if (inProgress.length > 0)
+        parts.push(`${inProgress.length} in progress`);
+    if (pending.length > 0)
+        parts.push(`${pending.length} pending`);
+    if (completed.length > 0)
+        parts.push(`${completed.length} recently completed`);
+    return parts.join(', ') || 'No tasks tracked';
+}
+async function gatherKnowledgeContext(runtime, sessionManager, sessionId, input) {
+    const recentNotes = [];
+    const codeSnippets = [];
+    if (input.includeScratchpad) {
+        const manager = sessionManager;
+        const outcome = await attempt(runtime, async () => {
+            if (!manager)
+                throw new Error('session/manager context is unavailable');
+            return manager.listScratchpad(sessionId, { limit: 20, offset: 0 });
+        }, 'context-summary scratchpad');
+        if (outcome.ok) {
+            for (const entry of outcome.value) {
+                const preview = entry.preview;
+                if (entry.contentType === 'code') {
+                    codeSnippets.push({
+                        key: entry.key,
+                        preview,
+                        language: entry.language
+                    });
+                }
+                else {
+                    recentNotes.push({
+                        key: entry.key,
+                        contentType: entry.contentType,
+                        preview,
+                        updatedAt: entry.updatedAt.toISOString()
+                    });
+                }
+            }
+        }
+    }
+    return { recentNotes, codeSnippets, totalEntries: recentNotes.length + codeSnippets.length };
+}
+async function gatherCodeContext() {
+    return { recentSymbols: [], diagnosticHotspots: [], recentDependencies: [] };
+}
+async function getSessionInfo(runtime, sessionManager, sessionId) {
+    const manager = sessionManager;
+    if (!manager)
+        return undefined;
+    const outcome = await attempt(runtime, () => manager.getSession(sessionId), 'context-summary session info');
+    if (!outcome.ok)
+        return undefined;
+    const session = outcome.value;
+    return session
+        ? { title: session.title ?? undefined, description: session.description ?? undefined }
+        : undefined;
+}
+function generatePreservationInstructions(fileContext, taskContext, knowledgeContext, codeContext, customInstructions) {
+    const instructions = [];
+    instructions.push('## Context Preservation Guidelines\n');
+    if (fileContext.recentlyEdited.length > 0) {
+        instructions.push('### Modified Files (High Priority)');
+        instructions.push('These files were edited in this session and should be prioritized:');
+        fileContext.recentlyEdited.slice(0, 10).forEach((f) => instructions.push(`- ${f.filePath}`));
+        instructions.push('');
+    }
+    if (fileContext.hotspots.length > 0) {
+        instructions.push('### File Hotspots');
+        instructions.push('Files with high relevance scores based on access patterns:');
+        fileContext.hotspots
+            .slice(0, 10)
+            .forEach((h) => instructions.push(`- ${h.path} (score: ${h.score.toFixed(2)}, ${h.reason})`));
+        instructions.push('');
+    }
+    if (taskContext.inProgress.length > 0) {
+        instructions.push('### Current Task Focus');
+        taskContext.inProgress.forEach((t) => {
+            instructions.push(`- [IN PROGRESS] ${t.content}`);
+        });
+        instructions.push('');
+    }
+    if (taskContext.pending.length > 0) {
+        instructions.push('### Pending Tasks');
+        taskContext.pending.slice(0, 5).forEach((t) => {
+            instructions.push(`- [${t.priority}] ${t.content}`);
+        });
+        instructions.push('');
+    }
+    if (knowledgeContext.recentNotes.length > 0) {
+        instructions.push('### Session Notes');
+        instructions.push('Important notes captured during this session:');
+        knowledgeContext.recentNotes.slice(0, 5).forEach((e) => {
+            instructions.push(`- **${e.key}**: ${e.preview.slice(0, 100)}...`);
+        });
+        instructions.push('');
+    }
+    instructions.push('### Summary');
+    instructions.push(`Files: ${fileContext.recentlyEdited.length} edited, ${fileContext.recentlyRead.length} read`);
+    instructions.push(taskContext.summary);
+    instructions.push(`Notes: ${knowledgeContext.totalEntries} entries`);
+    if (codeContext) {
+        instructions.push(`Symbols: ${codeContext.recentSymbols.length} tracked`);
+    }
+    if (customInstructions) {
+        instructions.push('\n### Additional Instructions');
+        instructions.push(customInstructions);
+    }
+    return instructions.join('\n');
+}
+function formatSummary(summary, format) {
+    switch (format) {
+        case 'json':
+            return JSON.stringify(summary, null, 2);
+        case 'markdown':
+            return formatAsMarkdown(summary);
+        case 'compact':
+            return formatAsCompact(summary);
+        default:
+            return JSON.stringify(summary, null, 2);
+    }
+}
+function formatAsMarkdown(summary) {
+    const lines = [];
+    lines.push(`# Context Summary`);
+    lines.push(`Generated: ${summary.generatedAt}`);
+    if (summary.sessionTitle) {
+        lines.push(`Session: ${summary.sessionTitle}`);
+    }
+    lines.push('');
+    lines.push(summary.preservationInstructions);
+    return lines.join('\n');
+}
+function formatAsCompact(summary) {
+    const parts = [];
+    const editCount = summary.fileContext.recentlyEdited.length;
+    const readCount = summary.fileContext.recentlyRead.length;
+    parts.push(`Files: ${editCount} edited, ${readCount} read`);
+    const activeCount = summary.taskContext.inProgress.length + summary.taskContext.pending.length;
+    if (activeCount > 0)
+        parts.push(`Tasks: ${activeCount} active`);
+    const noteCount = summary.knowledgeContext.totalEntries;
+    if (noteCount > 0)
+        parts.push(`Notes: ${noteCount}`);
+    if (summary.fileContext.recentlyEdited.length > 0) {
+        const topFiles = summary.fileContext.recentlyEdited
+            .slice(0, 3)
+            .map((f) => f.filePath.split('/').pop());
+        parts.push(`Key: ${topFiles.join(', ')}`);
+    }
+    return parts.join(' | ');
+}
+//# sourceMappingURL=context-summary.js.map

package/dist/tools/unified/handlers/context-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-summary.js","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/context-summary.ts"],"names":[],"mappings":"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"}

package/dist/tools/unified/handlers/file-access-list.d.ts

@@ -0,0 +1,4 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { FileAccessListInput, ExternalOutput } from '../schemas.ts';
+export declare function handleFileAccessList(runtime: VibesRuntime, input: FileAccessListInput): Promise<ExternalOutput>;
+//# sourceMappingURL=file-access-list.d.ts.map

package/dist/tools/unified/handlers/file-access-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-list.d.ts","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/file-access-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIzE,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,mBAAmB,GACxB,OAAO,CAAC,cAAc,CAAC,CA2CzB"}

package/dist/tools/unified/handlers/file-access-list.js

@@ -0,0 +1,39 @@
+import { ExternalClient } from "../../../client/external-client.js";
+import { resolveExternalSessionId } from "../../../session-capability.js";
+export async function handleFileAccessList(runtime, input) {
+    const sessionId = input.sessionId ?? (await resolveExternalSessionId(runtime));
+    if (!sessionId) {
+        throw new Error('No active session found. Use session-init to create a new session, or provide sessionId explicitly.');
+    }
+    const external = new ExternalClient(undefined, undefined, runtime);
+    const accesses = await external.listFileAccesses({
+        sessionId,
+        operation: input.operation,
+        filePath: input.filePath,
+        since: input.since ? new Date(input.since) : undefined,
+        limit: input.limit,
+        offset: 0
+    });
+    let stats;
+    if (input.includeStats) {
+        stats = await external.fileAccessStats(sessionId, input.limit);
+    }
+    const summary = await external.fileAccessSummary(sessionId);
+    return {
+        message: `Found ${accesses.length} file accesses across ${summary.totalFiles} files`,
+        data: {
+            sessionId,
+            totalFiles: summary.totalFiles,
+            totalAccesses: summary.totalAccesses,
+            stats,
+            recentAccesses: accesses.map((a) => ({
+                id: a.id,
+                filePath: a.filePath,
+                operation: a.operation,
+                timestamp: a.timestamp.toISOString(),
+                toolName: a.toolName
+            }))
+        }
+    };
+}
+//# sourceMappingURL=file-access-list.js.map

package/dist/tools/unified/handlers/file-access-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-list.js","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/file-access-list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,OAAqB,EACrB,KAA0B;IAE1B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/E,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACd,qGAAqG,CACrG,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC;QAChD,SAAS;QACT,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACtD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,CAAC;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC;IACV,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE5D,OAAO;QACN,OAAO,EAAE,SAAS,QAAQ,CAAC,MAAM,yBAAyB,OAAO,CAAC,UAAU,QAAQ;QACpF,IAAI,EAAE;YACL,SAAS;YACT,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,KAAK;YACL,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;gBACpC,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACpB,CAAC,CAAC;SACH;KACD,CAAC;AACH,CAAC"}

package/dist/tools/unified/handlers/file-access-track.d.ts

@@ -0,0 +1,4 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { FileAccessTrackInput, ExternalOutput } from '../schemas.ts';
+export declare function handleFileAccessTrack(runtime: VibesRuntime, input: FileAccessTrackInput): Promise<ExternalOutput>;
+//# sourceMappingURL=file-access-track.d.ts.map

package/dist/tools/unified/handlers/file-access-track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-track.d.ts","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/file-access-track.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAI1E,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,cAAc,CAAC,CAoCzB"}

package/dist/tools/unified/handlers/file-access-track.js

@@ -0,0 +1,34 @@
+import { ExternalClient } from "../../../client/external-client.js";
+import { resolveExternalSessionId } from "../../../session-capability.js";
+export async function handleFileAccessTrack(runtime, input) {
+    const sessionId = input.sessionId ?? (await resolveExternalSessionId(runtime));
+    if (!sessionId) {
+        throw new Error('No active session found. Use session-init to create a new session, or provide sessionId explicitly.');
+    }
+    const external = new ExternalClient(undefined, undefined, runtime);
+    const access = await external.trackFileAccess({
+        sessionId,
+        filePath: input.filePath,
+        operation: input.operation,
+        lineRange: input.lineRange,
+        symbolsAccessed: input.symbolsAccessed,
+        bytesRead: input.bytesRead,
+        bytesWritten: input.bytesWritten,
+        diagnosticsCount: input.diagnosticsCount,
+        activeTodoId: input.activeTodoId,
+        toolName: input.toolName,
+        toolCallId: input.toolCallId,
+        metadata: input.metadata,
+        timestamp: new Date()
+    });
+    return {
+        message: `Tracked ${access.operation} on ${access.filePath}`,
+        data: {
+            id: access.id,
+            filePath: access.filePath,
+            operation: access.operation,
+            timestamp: access.timestamp.toISOString()
+        }
+    };
+}
+//# sourceMappingURL=file-access-track.js.map

package/dist/tools/unified/handlers/file-access-track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-track.js","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/file-access-track.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,OAAqB,EACrB,KAA2B;IAE3B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/E,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACd,qGAAqG,CACrG,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC;QAC7C,SAAS;QACT,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE;KACrB,CAAC,CAAC;IAEH,OAAO;QACN,OAAO,EAAE,WAAW,MAAM,CAAC,SAAS,OAAO,MAAM,CAAC,QAAQ,EAAE;QAC5D,IAAI,EAAE;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;SACzC;KACD,CAAC;AACH,CAAC"}

package/dist/tools/unified/handlers/hook-call.d.ts

@@ -0,0 +1,23 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import { type ValueFreeFailure } from '@vibesdotdev/kernel';
+import type { ToolCallContext } from '@vibesdotdev/kernel/schemas/tool-call';
+import { type HookCallOutput } from '../../../hooks/call.ts';
+import type { HookCallActionInput } from '../schemas.ts';
+/** The adapter's typed rejection, rendered to the harness in `stdout`. */
+interface HookCallRejection {
+    code: string;
+    reason?: string;
+    message: string;
+    cause: ValueFreeFailure;
+}
+/** Execute an external lifecycle event inside the persistent runtime body. */
+export declare function handleHookCall(runtime: VibesRuntime, input: HookCallActionInput, ctx: ToolCallContext): Promise<{
+    message: string;
+    data: {
+        stdout: string;
+        result?: HookCallOutput;
+        rejection?: HookCallRejection;
+    };
+}>;
+export {};
+//# sourceMappingURL=hook-call.d.ts.map

package/dist/tools/unified/handlers/hook-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-call.d.ts","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/hook-call.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAwD,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAO7E,OAAO,EAIN,KAAK,cAAc,EACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAczD,0EAA0E;AAC1E,UAAU,iBAAiB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;CACxB;AAED,8EAA8E;AAC9E,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,eAAe,GAClB,OAAO,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,cAAc,CAAC;QACxB,SAAS,CAAC,EAAE,iBAAiB,CAAC;KAC9B,CAAC;CACF,CAAC,CA2ED"}