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

package/dist/tools/unified/handlers/hook-call.js

@@ -0,0 +1,86 @@
+import { CapabilityError, isCapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import { UNKNOWN_EXTERNAL_TARGET_HINT } from "../../../external-tool/runtime.js";
+import { createRuntimeMcpClient, executeHookCall, HookCallInputSchema } from "../../../hooks/call.js";
+import { formatValidHookEvents, resolveHookLifecycleEvent } from "../../../hooks/resolve-event.js";
+function renderedOutput(output, result) {
+    if (output === 'json')
+        return JSON.stringify(result);
+    if (output === 'text')
+        return result.context ?? '';
+    return '';
+}
+/** Execute an external lifecycle event inside the persistent runtime body. */
+export async function handleHookCall(runtime, input, ctx) {
+    const descriptor = runtime.query('external/host').withId(input.target).descriptors()[0];
+    if (!descriptor) {
+        throw new CapabilityError(`External tool '${input.target}' is not registered`, 'NOT_FOUND', {
+            reason: 'external-target-unknown',
+            recoveryHint: UNKNOWN_EXTERNAL_TARGET_HINT
+        });
+    }
+    const event = resolveHookLifecycleEvent(input.event, descriptor.manifest.hooks.nativeEventMap);
+    if (!event) {
+        throw new CapabilityError(`Invalid event: ${input.event}`, 'INVALID_INPUT', {
+            recoveryHint: `Valid events: ${formatValidHookEvents(descriptor.manifest.hooks.nativeEventMap)}`
+        });
+    }
+    const adapterId = descriptor.manifest.integration.hooks?.hookAdapterId;
+    const adapter = adapterId
+        ? await runtime.query('external/hook-adapter').withId(adapterId).resolve()
+        : undefined;
+    let envelope;
+    let prompt = input.prompt;
+    if (adapter) {
+        // This runs inside a shared host: the hook's workspace and native session
+        // are the invocation's (its ToolCallContext), never the host's own.
+        const invocation = {};
+        if (ctx.workspace?.root)
+            invocation.workspace = ctx.workspace.root;
+        if (ctx.caller?.harnessSessionId)
+            invocation.sessionId = ctx.caller.harnessSessionId;
+        // A detached SessionEnd whose harness closed stdin carries nothing to
+        // normalize: the one supported empty input, skipped. Any other missing,
+        // malformed or unattributed payload is the adapter's typed rejection,
+        // rendered to the harness in its dialect; every other failure propagates.
+        if (!input.stdin && event === 'session.end')
+            return { message: 'Hook skipped', data: { stdout: '' } };
+        try {
+            if (!input.stdin) {
+                throw new CapabilityError(`${input.target} ${input.event} hook received no stdin payload`, 'INVALID_INPUT', { reason: 'hook-payload-missing', details: { target: input.target, event } });
+            }
+            envelope = await adapter.normalize(event, input.stdin, invocation);
+            prompt = envelope.prompt ?? prompt;
+        }
+        catch (error) {
+            if (!(error instanceof Error && isCapabilityError(error)) || error.code !== 'INVALID_INPUT')
+                throw error;
+            const stdout = (await adapter.render({ success: false, event, error: error.message })) ?? '';
+            // Both branches carry the cause: the rejection outcome must forward the failure.
+            const rejection = error.reason
+                ? { code: error.code, reason: error.reason, message: error.message, cause: valueFreeFailure(error) }
+                : { code: error.code, message: error.message, cause: valueFreeFailure(error) };
+            return {
+                message: 'Hook input rejected',
+                data: { stdout, rejection }
+            };
+        }
+    }
+    const hookInput = HookCallInputSchema.parse({
+        event,
+        target: input.target,
+        disableBrain: input.disableBrain,
+        disablePrompts: input.disablePrompts,
+        output: input.output === 'json' ? 'json' : 'text',
+        prompt,
+        envelope
+    });
+    const result = await executeHookCall(hookInput, {
+        runtime,
+        mcpFactory: (timeoutMs) => createRuntimeMcpClient({ runtime, ctx, timeoutMs })
+    });
+    const stdout = input.output === 'native' && adapter
+        ? ((await adapter.render(result)) ?? '')
+        : renderedOutput(input.output, result);
+    return { message: 'Hook dispatched', data: { stdout, result } };
+}
+//# sourceMappingURL=hook-call.js.map

package/dist/tools/unified/handlers/hook-call.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-generator.d.ts","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/hook-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIxE,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAAC,cAAc,CAAC,CAsCzB"}

package/dist/tools/unified/handlers/hook-generator.js

@@ -0,0 +1,37 @@
+import { join, resolveFileSystemAdapter } from '@vibesdotdev/filesystem';
+import { resolveExternalHostImplementation } from "../../../external-tool/runtime.js";
+export async function handleHookGenerator(runtime, input) {
+    const { target, hookType, vibesPath, outputDir, writeFiles } = input;
+    const externalTool = await resolveExternalHostImplementation(runtime, target);
+    const result = await externalTool.generateHooks({
+        global: false,
+        // The invocation's workspace (its overlay, else the host's binding).
+        projectDir: await runtime.context('runtime/workspace-path'),
+        dryRun: true,
+        hooks: hookType ? [hookType] : undefined,
+        vibesPath
+    });
+    const hooks = result.templates;
+    const filesWritten = [];
+    if (writeFiles && outputDir) {
+        const fs = await resolveFileSystemAdapter(runtime);
+        await fs.mkdir(outputDir, { recursive: true });
+        for (const hook of hooks) {
+            const hookPath = join(outputDir, hook.filename);
+            await fs.writeFile(hookPath, hook.content, { encoding: 'utf-8', mode: hook.mode ?? 0o755 });
+            filesWritten.push(hookPath);
+        }
+    }
+    return {
+        message: `${result.message}${writeFiles ? ` (${filesWritten.length} files written)` : ''}`,
+        data: {
+            target,
+            hooks,
+            hooksDir: result.hooksDir,
+            success: result.success,
+            error: result.error,
+            filesWritten: filesWritten.length > 0 ? filesWritten : undefined
+        }
+    };
+}
+//# sourceMappingURL=hook-generator.js.map

package/dist/tools/unified/handlers/hook-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-generator.js","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/hook-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAqB,EACrB,KAAyB;IAEzB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAErE,MAAM,YAAY,GAAG,MAAM,iCAAiC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,aAAa,CAAC;QAC/C,MAAM,EAAE,KAAK;QACb,qEAAqE;QACrE,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC;QACnE,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QACxC,SAAS;KACT,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;IAE/B,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAChD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;YAC5F,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACF,CAAC;IAED,OAAO;QACN,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1F,IAAI,EAAE;YACL,MAAM;YACN,KAAK;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SAChE;KACD,CAAC;AACH,CAAC"}

package/dist/tools/unified/handlers/signal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `signal-send` / `signal-inbox` — the talk-to-each-other half of ambient
+ * awareness.
+ *
+ * The collision notice tells you someone else is in your file. These let you
+ * ask them what they are doing, without knowing who they are.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type MessageAudience } from '../../../schemas/agent-message.ts';
+import type { ExternalOutput, SignalInboxInput, SignalSendInput } from '../schemas.ts';
+/** Signals use the session bound to this invocation, never a process default or caller override. */
+export declare function resolveSessionId(runtime: VibesRuntime, _explicit?: string): Promise<string>;
+/**
+ * Parse the forgiving `to` string into a typed audience.
+ *
+ * A bare path is accepted as `path:` because that is what a caller reaching for
+ * this after seeing a collision will type.
+ */
+export declare function parseAudience(to: string, workspaceRoot?: string): MessageAudience | null;
+export declare function handleSignalSend(runtime: VibesRuntime, input: SignalSendInput): Promise<ExternalOutput>;
+export declare function handleSignalInbox(runtime: VibesRuntime, input: SignalInboxInput): Promise<ExternalOutput>;
+//# sourceMappingURL=signal.d.ts.map

package/dist/tools/unified/handlers/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/signal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAiF,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEvI,OAAO,EAKN,KAAK,eAAe,EACpB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAmBvF,oGAAoG;AACpG,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOjG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAiBxF;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CAuCzB;AAED,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,gBAAgB,GACrB,OAAO,CAAC,cAAc,CAAC,CA4BzB"}

package/dist/tools/unified/handlers/signal.js

@@ -0,0 +1,114 @@
+/**
+ * `signal-send` / `signal-inbox` — the talk-to-each-other half of ambient
+ * awareness.
+ *
+ * The collision notice tells you someone else is in your file. These let you
+ * ask them what they are doing, without knowing who they are.
+ */
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { AgentMessageSchema, MESSAGE_TTL_MS, formatMessages } from "../../../schemas/agent-message.js";
+import { resolveMessageTransport } from "../../../ambient/message-transport.impl.js";
+import { resolveTouchIdentity } from "../../../storage/touch-identity.js";
+import { boundSessionIdOf } from '@vibesdotdev/kernel/schemas/scope';
+import { getLogger } from '@vibesdotdev/logging';
+/** Identity is optional for a signal: when it cannot be resolved, log why (value-free, on `runtime`) and send without it. */
+async function touchIdentityOrNone(runtime) {
+    const resolved = await resolveTouchIdentity(runtime).then((identity) => ({ identity }), (error) => ({ failure: valueFreeFailure(CaughtFailureSchema.parse(error)) }));
+    if ('identity' in resolved)
+        return resolved.identity;
+    getLogger('external.signal', runtime).warn('touch identity unavailable; sending without it', { failure: resolved.failure });
+    return {};
+}
+/** Signals use the session bound to this invocation, never a process default or caller override. */
+export async function resolveSessionId(runtime, _explicit) {
+    const sessionId = boundSessionIdOf(runtime.scope);
+    if (sessionId)
+        return sessionId;
+    throw new CapabilityError('A signal requires a session bound to its invocation.', 'INVALID_INPUT', {
+        reason: 'session-unbound',
+        recoveryHint: 'Run session init and invoke the signal through the bound transport.'
+    });
+}
+/**
+ * Parse the forgiving `to` string into a typed audience.
+ *
+ * A bare path is accepted as `path:` because that is what a caller reaching for
+ * this after seeing a collision will type.
+ */
+export function parseAudience(to, workspaceRoot) {
+    const trimmed = to.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed === 'workspace' || trimmed === 'workspace:') {
+        return workspaceRoot ? { kind: 'workspace', workspaceRoot } : null;
+    }
+    if (trimmed.startsWith('session:')) {
+        const sessionId = trimmed.slice('session:'.length).trim();
+        return sessionId ? { kind: 'session', sessionId } : null;
+    }
+    if (trimmed.startsWith('path:')) {
+        const filePath = trimmed.slice('path:'.length).trim();
+        return filePath ? { kind: 'path', filePath, workspaceRoot } : null;
+    }
+    // Bare value: treat as a path, which is the common case.
+    return { kind: 'path', filePath: trimmed, workspaceRoot };
+}
+export async function handleSignalSend(runtime, input) {
+    const sessionId = await resolveSessionId(runtime, input.sessionId);
+    const identity = await touchIdentityOrNone(runtime);
+    const audience = parseAudience(input.to, identity.workspaceRoot);
+    if (!audience) {
+        throw new Error(`Could not read "${input.to}" as an audience. Use path:<filePath>, session:<id>, or workspace.`);
+    }
+    const now = new Date();
+    const message = AgentMessageSchema.parse({
+        id: crypto.randomUUID(),
+        fromSessionId: sessionId,
+        fromMachineId: identity.machineId,
+        fromMachineName: identity.machineName,
+        fromWorkItemTitle: identity.workItemTitle,
+        audience,
+        body: input.body,
+        sentAt: now,
+        expiresAt: new Date(now.getTime() + MESSAGE_TTL_MS)
+    });
+    const transport = await resolveMessageTransport(runtime);
+    transport.send(message);
+    await transport.flush?.();
+    const target = audience.kind === 'path'
+        ? `whoever is in ${audience.filePath}`
+        : audience.kind === 'session'
+            ? `session ${audience.sessionId.slice(0, 8)}`
+            : 'everyone in this workspace';
+    return {
+        message: `Sent to ${target}. It expires in ${Math.round(MESSAGE_TTL_MS / 60000)} minutes if nobody picks it up.`,
+        data: { id: message.id, audience, expiresAt: message.expiresAt.toISOString() }
+    };
+}
+export async function handleSignalInbox(runtime, input) {
+    const sessionId = await resolveSessionId(runtime, input.sessionId);
+    const identity = await touchIdentityOrNone(runtime);
+    const transport = await resolveMessageTransport(runtime);
+    // An explicit inbox read claims session- and workspace-addressed mail. It
+    // cannot claim path-addressed mail, because "the files I am working in" is
+    // only knowable from an actual touch — that arrives on the tool result.
+    const claimed = await transport.claim({
+        sessionId,
+        workspaceRoot: identity.workspaceRoot,
+        filePaths: [],
+        limit: input.limit ?? 10
+    });
+    return {
+        message: formatMessages(claimed, input.limit ?? 10) ?? 'No messages.',
+        data: {
+            count: claimed.length,
+            messages: claimed.map((m) => ({
+                from: m.fromSessionId,
+                fromMachineName: m.fromMachineName,
+                body: m.body,
+                sentAt: m.sentAt.toISOString()
+            }))
+        }
+    };
+}
+//# sourceMappingURL=signal.js.map

package/dist/tools/unified/handlers/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../../../../src/tools/unified/handlers/signal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAA4C,MAAM,qBAAqB,CAAC;AAEvI,OAAO,EACN,kBAAkB,EAClB,cAAc,EACd,cAAc,EAGd,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKjD,6HAA6H;AAC7H,KAAK,UAAU,mBAAmB,CAAC,OAAqB;IACvD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC,IAAI,CACxD,CAAC,QAAQ,EAAmB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAC7C,CAAC,KAAK,EAAmB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAC7F,CAAC;IACF,IAAI,UAAU,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC;IACrD,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,gDAAgD,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5H,OAAO,EAAE,CAAC;AACX,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAqB,EAAE,SAAkB;IAC/E,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,IAAI,eAAe,CAAC,sDAAsD,EAAE,eAAe,EAAE;QAClG,MAAM,EAAE,iBAAiB;QACzB,YAAY,EAAE,qEAAqE;KACnF,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,aAAsB;IAC/D,MAAM,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QACzD,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IACD,yDAAyD;IACzD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,OAAqB,EACrB,KAAsB;IAEtB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,mBAAmB,KAAK,CAAC,EAAE,oEAAoE,CAC/F,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAiB,kBAAkB,CAAC,KAAK,CAAC;QACtD,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,aAAa,EAAE,SAAS;QACxB,aAAa,EAAE,QAAQ,CAAC,SAAS;QACjC,eAAe,EAAE,QAAQ,CAAC,WAAW;QACrC,iBAAiB,EAAE,QAAQ,CAAC,aAAa;QACzC,QAAQ;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,GAAG;QACX,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC;KACnD,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACzD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IAE1B,MAAM,MAAM,GACX,QAAQ,CAAC,IAAI,KAAK,MAAM;QACvB,CAAC,CAAC,iBAAiB,QAAQ,CAAC,QAAQ,EAAE;QACtC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS;YAC5B,CAAC,CAAC,WAAW,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAC7C,CAAC,CAAC,4BAA4B,CAAC;IAElC,OAAO;QACN,OAAO,EAAE,WAAW,MAAM,mBAAmB,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,iCAAiC;QAChH,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE;KAC9E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAqB,EACrB,KAAuB;IAEvB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEzD,0EAA0E;IAC1E,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC;QACrC,SAAS;QACT,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAC;IAEH,OAAO;QACN,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,cAAc;QACrE,IAAI,EAAE;YACL,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,IAAI,EAAE,CAAC,CAAC,aAAa;gBACrB,eAAe,EAAE,CAAC,CAAC,eAAe;gBAClC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE;aAC9B,CAAC,CAAC;SACH;KACD,CAAC;AACH,CAAC"}

package/dist/tools/unified/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * External Unified Tool Exports
+ */
+export { default as externalDescriptor } from './external.descriptor.ts';
+export { ExternalInputSchema, ExternalOutputSchema, FileAccessTrackInputSchema, FileAccessListInputSchema, ContextSummaryInputSchema, HookGeneratorInputSchema, InstallInputSchema, HookCallActionInputSchema, SignalSendInputSchema, SignalInboxInputSchema, type ExternalAction, type ExternalInput, type ExternalOutput, type FileAccessTrackInput, type FileAccessListInput, type ContextSummaryInput, type HookGeneratorInput, type InstallInput } from './schemas.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/unified/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EACN,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,MAAM,cAAc,CAAC"}

package/dist/tools/unified/index.js

@@ -0,0 +1,6 @@
+/**
+ * External Unified Tool Exports
+ */
+export { default as externalDescriptor } from "./external.descriptor.js";
+export { ExternalInputSchema, ExternalOutputSchema, FileAccessTrackInputSchema, FileAccessListInputSchema, ContextSummaryInputSchema, HookGeneratorInputSchema, InstallInputSchema, HookCallActionInputSchema, SignalSendInputSchema, SignalInboxInputSchema } from "./schemas.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/unified/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EACN,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EAStB,MAAM,cAAc,CAAC"}

package/dist/tools/unified/install/handler.d.ts

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

package/dist/tools/unified/install/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/tools/unified/install/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGlE,wBAAsB,aAAa,CAClC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAgBzB"}

package/dist/tools/unified/install/handler.js

@@ -0,0 +1,17 @@
+import { resolveExternalHostImplementation } from "../../../external-tool/runtime.js";
+export async function handleInstall(runtime, input) {
+    const { target, projectDir, global: installGlobal, vibesPath, dryRun, hooks } = input;
+    // A global install never reads the workspace; a project install without an
+    // explicit directory installs into the invocation's workspace.
+    const cwd = projectDir || (installGlobal ? undefined : await runtime.context('runtime/workspace-path'));
+    const externalHost = await resolveExternalHostImplementation(runtime, target);
+    const result = await externalHost.installHooks({
+        global: installGlobal,
+        projectDir: cwd,
+        vibesPath,
+        dryRun,
+        hooks: [...hooks]
+    });
+    return { message: result.message, data: result };
+}
+//# sourceMappingURL=handler.js.map

package/dist/tools/unified/install/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../src/tools/unified/install/handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,MAAM,mCAAmC,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,OAAqB,EACrB,KAAmB;IAEnB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACtF,2EAA2E;IAC3E,+DAA+D;IAC/D,MAAM,GAAG,GACR,UAAU,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC,CAAC;IACrG,MAAM,YAAY,GAAG,MAAM,iCAAiC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC;QAC9C,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,GAAG;QACf,SAAS;QACT,MAAM;QACN,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC;KACjB,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAClD,CAAC"}

package/dist/tools/unified/runtime.d.ts

@@ -0,0 +1,35 @@
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolCallContext } from '@vibesdotdev/kernel/schemas/tool-call';
+import type { ExternalInput, ExternalOutput } from './schemas.ts';
+export declare const EXTERNAL_ACTION_KIND: "external/action";
+export declare const ExternalActionDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"external/action">;
+}, z.core.$strip>;
+export type ExternalActionDescriptor = z.infer<typeof ExternalActionDescriptorSchema>;
+export interface ExternalActionImplementation {
+    execute(input: ExternalInput, runtime: VibesRuntime, context: ToolCallContext): Promise<ExternalOutput>;
+}
+export declare const externalActionKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<unknown>;
+export declare function createExternalActionDescriptor(id: string, name: string, description: string): ExternalActionDescriptor;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/tools/unified/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAElE,eAAO,MAAM,oBAAoB,EAAG,iBAA0B,CAAC;AAE/D,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;iBAEzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,MAAM,WAAW,4BAA4B;IAC5C,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACxG;AAED,eAAO,MAAM,kBAAkB,oEAG7B,CAAC;AAEH,wBAAgB,8BAA8B,CAC7C,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GACjB,wBAAwB,CAU1B"}

package/dist/tools/unified/runtime.js

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+import { createRuntimeKind } from '@vibesdotdev/kernel';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+export const EXTERNAL_ACTION_KIND = 'external/action';
+export const ExternalActionDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal(EXTERNAL_ACTION_KIND)
+});
+export const externalActionKind = createRuntimeKind({
+    id: EXTERNAL_ACTION_KIND,
+    descriptorSchema: ExternalActionDescriptorSchema
+});
+export function createExternalActionDescriptor(id, name, description) {
+    return ExternalActionDescriptorSchema.parse({
+        kind: EXTERNAL_ACTION_KIND,
+        id,
+        name,
+        description,
+        tags: ['external', 'action'],
+        hardware: ['consumer'],
+        enabled: true
+    });
+}
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/tools/unified/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAqB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAIjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAA0B,CAAC;AAE/D,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;CACrC,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;IACnD,EAAE,EAAE,oBAAoB;IACxB,gBAAgB,EAAE,8BAA8B;CAChD,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAC7C,EAAU,EACV,IAAY,EACZ,WAAmB;IAEnB,OAAO,8BAA8B,CAAC,KAAK,CAAC;QAC3C,IAAI,EAAE,oBAAoB;QAC1B,EAAE;QACF,IAAI;QACJ,WAAW;QACX,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC5B,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,OAAO,EAAE,IAAI;KACb,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/unified/schemas.d.ts

@@ -0,0 +1,160 @@
+/**
+ * External Unified Tool Schemas
+ *
+ * Open envelope for runtime-discovered external integration actions.
+ */
+import * as z from 'zod/v4';
+/** Track a file access event */
+export declare const FileAccessTrackInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"file-access-track">;
+    sessionId: z.ZodOptional<z.ZodUUID>;
+    filePath: z.ZodString;
+    operation: z.ZodEnum<{
+        read: "read";
+        write: "write";
+        delete: "delete";
+        edit: "edit";
+    }>;
+    lineRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strip>>;
+    symbolsAccessed: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    bytesRead: z.ZodOptional<z.ZodNumber>;
+    bytesWritten: z.ZodOptional<z.ZodNumber>;
+    diagnosticsCount: z.ZodOptional<z.ZodNumber>;
+    activeTodoId: z.ZodOptional<z.ZodUUID>;
+    toolName: z.ZodOptional<z.ZodString>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** List file access history */
+export declare const FileAccessListInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"file-access-list">;
+    sessionId: z.ZodOptional<z.ZodUUID>;
+    operation: z.ZodOptional<z.ZodEnum<{
+        read: "read";
+        write: "write";
+        delete: "delete";
+        edit: "edit";
+    }>>;
+    filePath: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodISODateTime>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    includeStats: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Generate context preservation summary */
+export declare const ContextSummaryInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"context-summary">;
+    sessionId: z.ZodOptional<z.ZodUUID>;
+    maxFiles: z.ZodDefault<z.ZodNumber>;
+    includeCodeContext: z.ZodDefault<z.ZodBoolean>;
+    includeTodos: z.ZodDefault<z.ZodBoolean>;
+    includeScratchpad: z.ZodDefault<z.ZodBoolean>;
+    includeKnowledge: z.ZodDefault<z.ZodBoolean>;
+    timeWindowHours: z.ZodDefault<z.ZodNumber>;
+    format: z.ZodDefault<z.ZodEnum<{
+        json: "json";
+        markdown: "markdown";
+        compact: "compact";
+    }>>;
+    customInstructions: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Generate integration hooks */
+export declare const HookGeneratorInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"hook-generator">;
+    target: z.ZodString;
+    hookType: z.ZodOptional<z.ZodEnum<{
+        "session.start": "session.start";
+        "session.end": "session.end";
+        "prompt.submit": "prompt.submit";
+        "tool.before": "tool.before";
+        "tool.after": "tool.after";
+        "context.beforeCompact": "context.beforeCompact";
+        "context.afterCompact": "context.afterCompact";
+        "permission.request": "permission.request";
+        "agent.stop": "agent.stop";
+        "subagent.stop": "subagent.stop";
+        notification: "notification";
+    }>>;
+    vibesPath: z.ZodDefault<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    writeFiles: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Install integration hooks */
+export declare const InstallInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"install">;
+    target: z.ZodString;
+    projectDir: z.ZodOptional<z.ZodString>;
+    global: z.ZodDefault<z.ZodBoolean>;
+    vibesPath: z.ZodDefault<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    hooks: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        "session.start": "session.start";
+        "session.end": "session.end";
+        "prompt.submit": "prompt.submit";
+        "tool.before": "tool.before";
+        "tool.after": "tool.after";
+        "context.beforeCompact": "context.beforeCompact";
+        "context.afterCompact": "context.afterCompact";
+        "permission.request": "permission.request";
+        "agent.stop": "agent.stop";
+        "subagent.stop": "subagent.stop";
+        notification: "notification";
+    }>>>;
+}, z.core.$strip>;
+/**
+ * Relay a native external-host lifecycle event into the persistent consumer
+ * runtime. The CLI host recognizes this one operation before general CLI
+ * bootstrap, so each event reuses the daemon instead of creating another Vibes
+ * body. Raw provider input is normalized by the registered owner adapter here.
+ */
+export declare const HookCallActionInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"hook-call">;
+    event: z.ZodString;
+    target: z.ZodString;
+    stdin: z.ZodOptional<z.ZodString>;
+    disableBrain: z.ZodDefault<z.ZodBoolean>;
+    disablePrompts: z.ZodDefault<z.ZodBoolean>;
+    output: z.ZodDefault<z.ZodEnum<{
+        text: "text";
+        json: "json";
+        native: "native";
+    }>>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SignalSendInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"signal-send">;
+    to: z.ZodString;
+    body: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Read messages addressed to this agent right now, without waiting for an edit. */
+export declare const SignalInboxInputSchema: z.ZodObject<{
+    action: z.ZodLiteral<"signal-inbox">;
+    limit: z.ZodOptional<z.ZodNumber>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ExternalAction = string;
+export declare const ExternalInputSchema: z.ZodObject<{
+    action: z.ZodString;
+}, z.core.$loose>;
+export type ExternalInput = z.infer<typeof ExternalInputSchema>;
+export type SignalSendInput = z.infer<typeof SignalSendInputSchema>;
+export type SignalInboxInput = z.infer<typeof SignalInboxInputSchema>;
+export type FileAccessTrackInput = z.infer<typeof FileAccessTrackInputSchema>;
+export type FileAccessListInput = z.infer<typeof FileAccessListInputSchema>;
+export type ContextSummaryInput = z.infer<typeof ContextSummaryInputSchema>;
+export type HookGeneratorInput = z.infer<typeof HookGeneratorInputSchema>;
+export type InstallInput = z.infer<typeof InstallInputSchema>;
+export type HookCallActionInput = z.infer<typeof HookCallActionInputSchema>;
+/**
+ * Generic output schema for external operations.
+ * Each action handler returns its own specific structure, but all include a message.
+ */
+export declare const ExternalOutputSchema: z.ZodObject<{
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type ExternalOutput = z.infer<typeof ExternalOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/unified/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAO5B,gCAAgC;AAChC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;iBAcrC,CAAC;AAEH,+BAA+B;AAC/B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAQpC,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;iBAWpC,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;iBAOnC,CAAC;AAEH,gCAAgC;AAChC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;iBAU7B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAYpC,CAAC;AAwBH,eAAO,MAAM,qBAAqB;;;;;iBAShC,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,sBAAsB;;;;iBAIjC,CAAC;AAIH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,eAAO,MAAM,mBAAmB;;iBAIjB,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}