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

package/dist/svelte/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@vibesdotdev/external/svelte`
+ *
+ * Designed Kit ToolCard for the unified `external` integration tool.
+ * Importing the root does NOT register the widget; hosts import
+ * `@vibesdotdev/external/svelte/plugin` (or `/svelte/tool-widgets`) so Chat
+ * discovers the card through `tools/ui`.
+ */
+export { default as ExternalToolCard } from './tool-widgets/ExternalToolCard.svelte';
+export { EXTERNAL_TOOL_CARD_DEFAULT_ICON, EXTERNAL_TOOL_CARD_ITEM_LIMIT, summarizeExternalToolCall, type ExternalToolCallViewInput, type ExternalToolCardDetail, type ExternalToolCardItem, type ExternalToolCardView } from './tool-widgets/summary.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EACN,+BAA+B,EAC/B,6BAA6B,EAC7B,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,MAAM,2BAA2B,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,10 @@
+/**
+ * `@vibesdotdev/external/svelte`
+ *
+ * Designed Kit ToolCard for the unified `external` integration tool.
+ * Importing the root does NOT register the widget; hosts import
+ * `@vibesdotdev/external/svelte/plugin` (or `/svelte/tool-widgets`) so Chat
+ * discovers the card through `tools/ui`.
+ */
+export { default as ExternalToolCard } from './tool-widgets/ExternalToolCard.svelte';
+export { EXTERNAL_TOOL_CARD_DEFAULT_ICON, EXTERNAL_TOOL_CARD_ITEM_LIMIT, summarizeExternalToolCall } from "./tool-widgets/summary.js";

package/dist/svelte/styles.css

@@ -0,0 +1,8 @@
+/*
+ * Tailwind v4 source declaration for consumers — mirrors @vibesdotdev/kit's
+ * styles.css pattern. Apps that @import this file get this package's
+ * components scanned by their Tailwind build, so utility classes used only
+ * inside these components are emitted in the app's CSS bundle (Tailwind
+ * never scans node_modules). Paths resolve relative to this file.
+ */
+@source "./";

package/dist/svelte/tool-widgets/ExternalToolCard.svelte

@@ -0,0 +1,71 @@
+<script lang="ts">
+	/**
+	 * Designed Kit card for the unified `external` tool — action, result
+	 * message, and the few fields operators actually read.
+	 */
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import {
+		ToolCard,
+		ToolCardBody,
+		type ToolWidgetProps
+	} from '@vibesdotdev/kit/components/tool-widgets';
+	import { summarizeExternalToolCall } from './summary.js';
+
+	let { tool, compact = false }: ToolWidgetProps = $props();
+
+	const view = $derived(summarizeExternalToolCall(tool));
+	const empty = $derived(
+		!view.message && view.details.length === 0 && view.items.length === 0 && !tool.error
+	);
+</script>
+
+<ToolCard {tool} {compact} title={view.title} icon={view.icon}>
+	{#snippet children()}
+		<ToolCardBody {compact}>
+			{#if view.action}
+				<Badge variant="outline" class="text-caption">{view.action}</Badge>
+			{/if}
+			{#if view.message}
+				<p class="text-muted-foreground">{view.message}</p>
+			{/if}
+			{#if view.details.length}
+				<dl class="space-y-1">
+					{#each view.details as detail (detail.label)}
+						<div class="flex min-w-0 items-start gap-2">
+							<dt
+								class="shrink-0 text-caption font-medium tracking-wider text-muted-foreground uppercase"
+							>
+								{detail.label}
+							</dt>
+							<dd class="min-w-0 truncate font-mono text-footnote text-foreground">
+								{detail.value}
+							</dd>
+						</div>
+					{/each}
+				</dl>
+			{/if}
+			{#if view.items.length}
+				<ul class="space-y-1">
+					{#each view.items as item (item.id)}
+						<li class="flex min-w-0 items-center gap-1.5">
+							<Icon
+								icon={item.icon ?? 'lucide:dot'}
+								class="size-3 shrink-0 text-muted-foreground"
+							/>
+							<span class="min-w-0 flex-1 truncate text-foreground">{item.title}</span>
+							{#if item.meta}
+								<span class="shrink-0 font-mono text-caption text-muted-foreground">
+									{item.meta}
+								</span>
+							{/if}
+						</li>
+					{/each}
+				</ul>
+			{/if}
+			{#if empty}
+				<p class="text-muted-foreground italic">Working…</p>
+			{/if}
+		</ToolCardBody>
+	{/snippet}
+</ToolCard>

package/dist/svelte/tool-widgets/ExternalToolCard.svelte.d.ts

@@ -0,0 +1,5 @@
+import { type ToolWidgetProps } from '@vibesdotdev/kit/components/tool-widgets';
+declare const ExternalToolCard: import("svelte").Component<ToolWidgetProps, {}, "">;
+type ExternalToolCard = ReturnType<typeof ExternalToolCard>;
+export default ExternalToolCard;
+//# sourceMappingURL=ExternalToolCard.svelte.d.ts.map

package/dist/svelte/tool-widgets/ExternalToolCard.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalToolCard.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/ExternalToolCard.svelte.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,eAAe,EACpB,MAAM,0CAA0C,CAAC;AAiEnD,QAAA,MAAM,gBAAgB,qDAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/svelte/tool-widgets/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ExternalToolCard } from './ExternalToolCard.svelte';
+export { EXTERNAL_TOOL_CARD_DEFAULT_ICON, EXTERNAL_TOOL_CARD_ITEM_LIMIT, summarizeExternalToolCall, type ExternalToolCallViewInput, type ExternalToolCardDetail, type ExternalToolCardItem, type ExternalToolCardView } from './summary.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/tool-widgets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACN,+BAA+B,EAC/B,6BAA6B,EAC7B,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,MAAM,cAAc,CAAC"}

package/dist/svelte/tool-widgets/index.js

@@ -0,0 +1,2 @@
+export { default as ExternalToolCard } from './ExternalToolCard.svelte';
+export { EXTERNAL_TOOL_CARD_DEFAULT_ICON, EXTERNAL_TOOL_CARD_ITEM_LIMIT, summarizeExternalToolCall } from "./summary.js";

package/dist/svelte/tool-widgets/summary.d.ts

@@ -0,0 +1,27 @@
+export declare const EXTERNAL_TOOL_CARD_ITEM_LIMIT = 8;
+export declare const EXTERNAL_TOOL_CARD_DEFAULT_ICON = "lucide:unplug";
+export interface ExternalToolCardDetail {
+    label: string;
+    value: string;
+}
+export interface ExternalToolCardItem {
+    id: string;
+    title: string;
+    meta?: string;
+    icon?: string;
+}
+export interface ExternalToolCardView {
+    title: string;
+    icon: string;
+    action: string;
+    message: string;
+    details: ExternalToolCardDetail[];
+    items: ExternalToolCardItem[];
+}
+export interface ExternalToolCallViewInput {
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+}
+export declare function summarizeExternalToolCall(tool: ExternalToolCallViewInput): ExternalToolCardView;
+//# sourceMappingURL=summary.d.ts.map

package/dist/svelte/tool-widgets/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/svelte/tool-widgets/summary.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,+BAA+B,kBAAkB,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AA2DD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,yBAAyB,GAAG,oBAAoB,CAyI/F"}

package/dist/svelte/tool-widgets/summary.js

@@ -0,0 +1,198 @@
+/**
+ * Presentation model for the designed `external` Kit tool card.
+ *
+ * Reads the unified `{ action, ...payload }` envelope and `{ message, data }`
+ * output without assuming every action is registered yet.
+ */
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+export const EXTERNAL_TOOL_CARD_ITEM_LIMIT = 8;
+export const EXTERNAL_TOOL_CARD_DEFAULT_ICON = 'lucide:unplug';
+const ACTION_ICONS = new Map(Object.entries({
+    'file-access-track': 'lucide:file-pen-line',
+    'file-access-list': 'lucide:files',
+    'context-summary': 'lucide:notebook-text',
+    'hook-generator': 'lucide:puzzle',
+    install: 'lucide:plug',
+    'hook-call': 'lucide:zap',
+    'signal-send': 'lucide:send',
+    'signal-inbox': 'lucide:inbox'
+}));
+const ToolCardRecordSchema = z.record(z.string(), JsonValueSchema);
+const ToolCardStringSchema = z.string();
+const ToolCardNumberSchema = z.number();
+function rec(value) {
+    const parsed = ToolCardRecordSchema.safeParse(value);
+    if (!parsed.success)
+        return null;
+    return parsed.data;
+}
+function str(value) {
+    const parsed = ToolCardStringSchema.safeParse(value);
+    if (!parsed.success)
+        return '';
+    return parsed.data.trim();
+}
+function num(value) {
+    const parsed = ToolCardNumberSchema.safeParse(value);
+    if (!parsed.success)
+        return null;
+    return Number.isFinite(parsed.data) ? parsed.data : null;
+}
+function basename(path) {
+    const trimmed = path.replace(/[\\/]+$/u, '');
+    const parts = trimmed.split(/[\\/]/u);
+    return parts[parts.length - 1] || path;
+}
+function humanize(value) {
+    return value
+        .split(/[-_]/u)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+function pushDetail(details, label, value) {
+    if (value)
+        details.push({ label, value });
+}
+function takeItems(items) {
+    return items.slice(0, EXTERNAL_TOOL_CARD_ITEM_LIMIT);
+}
+export function summarizeExternalToolCall(tool) {
+    const input = rec(tool.input);
+    const output = rec(tool.output);
+    const data = rec(output?.data) ?? output;
+    const action = str(input?.action) || str(output?.action) || str(data?.action);
+    const message = str(output?.message);
+    const details = [];
+    const items = [];
+    let title = '';
+    let icon = ACTION_ICONS.get(action) ?? EXTERNAL_TOOL_CARD_DEFAULT_ICON;
+    switch (action) {
+        case 'file-access-track': {
+            const filePath = str(data?.filePath) || str(input?.filePath);
+            const operation = str(data?.operation) || str(input?.operation);
+            title = operation && filePath
+                ? `${humanize(operation)} · ${basename(filePath)}`
+                : filePath
+                    ? `Tracked ${basename(filePath)}`
+                    : 'Tracked file access';
+            if (operation === 'read')
+                icon = 'lucide:file-text';
+            pushDetail(details, 'Path', filePath);
+            pushDetail(details, 'Operation', operation);
+            break;
+        }
+        case 'file-access-list': {
+            const totalFiles = num(data?.totalFiles);
+            const totalAccesses = num(data?.totalAccesses);
+            title =
+                totalFiles !== null
+                    ? `File access · ${totalFiles} file${totalFiles === 1 ? '' : 's'}`
+                    : 'File access';
+            if (totalFiles !== null)
+                pushDetail(details, 'Files', String(totalFiles));
+            if (totalAccesses !== null)
+                pushDetail(details, 'Accesses', String(totalAccesses));
+            const recent = Array.isArray(data?.recentAccesses) ? data.recentAccesses : [];
+            items.push(...takeItems(recent
+                .map((row, index) => {
+                const recRow = rec(row);
+                const filePath = str(recRow?.filePath);
+                if (!filePath)
+                    return null;
+                return {
+                    id: str(recRow?.id) || `${filePath}:${index}`,
+                    title: basename(filePath),
+                    meta: str(recRow?.operation) || undefined,
+                    icon: 'lucide:file'
+                };
+            })
+                .filter((item) => item !== null)));
+            break;
+        }
+        case 'context-summary': {
+            const stats = rec(data?.stats) ?? data;
+            const totalFiles = num(stats?.totalFiles);
+            const totalTodos = num(stats?.totalTodos);
+            const totalNotes = num(stats?.totalScratchpadEntries);
+            title = 'Context summary';
+            if (totalFiles !== null)
+                pushDetail(details, 'Files', String(totalFiles));
+            if (totalTodos !== null)
+                pushDetail(details, 'Todos', String(totalTodos));
+            if (totalNotes !== null)
+                pushDetail(details, 'Notes', String(totalNotes));
+            pushDetail(details, 'Format', str(input?.format));
+            break;
+        }
+        case 'hook-generator': {
+            const target = str(data?.target) || str(input?.target);
+            const written = Array.isArray(data?.filesWritten) ? data.filesWritten.length : null;
+            title = target ? `Generated hooks · ${target}` : 'Generated hooks';
+            pushDetail(details, 'Target', target);
+            if (written !== null)
+                pushDetail(details, 'Files', String(written));
+            break;
+        }
+        case 'install': {
+            const target = str(input?.target) || str(data?.target);
+            title = target ? `Installed · ${target}` : 'Installed hooks';
+            pushDetail(details, 'Target', target);
+            if (input?.dryRun === true || data?.dryRun === true)
+                pushDetail(details, 'Mode', 'dry-run');
+            break;
+        }
+        case 'hook-call': {
+            const event = str(input?.event) || str(data?.event);
+            const target = str(input?.target) || str(data?.target);
+            title = event ? `Hook · ${event}` : 'Hook call';
+            pushDetail(details, 'Target', target);
+            pushDetail(details, 'Event', event);
+            break;
+        }
+        case 'signal-send': {
+            const to = str(input?.to);
+            const body = str(input?.body);
+            title = 'Signal sent';
+            pushDetail(details, 'To', to);
+            pushDetail(details, 'Message', body);
+            break;
+        }
+        case 'signal-inbox': {
+            const count = num(data?.count);
+            title =
+                count !== null ? `Inbox · ${count}` : 'Signal inbox';
+            if (count !== null)
+                pushDetail(details, 'Messages', String(count));
+            const messages = Array.isArray(data?.messages) ? data.messages : [];
+            items.push(...takeItems(messages
+                .map((row, index) => {
+                const recRow = rec(row);
+                const body = str(recRow?.body);
+                if (!body)
+                    return null;
+                const from = str(recRow?.fromMachineName) || str(recRow?.from) || 'agent';
+                return {
+                    id: str(recRow?.id) || `${from}:${index}`,
+                    title: body,
+                    meta: from,
+                    icon: 'lucide:message-square'
+                };
+            })
+                .filter((item) => item !== null)));
+            break;
+        }
+        default:
+            title = action ? `External · ${action}` : 'External';
+            break;
+    }
+    return {
+        title,
+        icon,
+        action,
+        message,
+        details,
+        items
+    };
+}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { externalDescriptor, ExternalInputSchema, ExternalOutputSchema } from './unified/index.ts';
+export type { ExternalAction, ExternalInput, ExternalOutput, FileAccessTrackInput, FileAccessListInput, ContextSummaryInput, HookGeneratorInput, InstallInput } from './unified/index.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEnG,YAAY,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,MAAM,oBAAoB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,2 @@
+export { externalDescriptor, ExternalInputSchema, ExternalOutputSchema } from "./unified/index.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/tools/unified/action-descriptors.d.ts

@@ -0,0 +1,185 @@
+export declare const fileAccessTrackActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const fileAccessListActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const contextSummaryActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const hookGeneratorActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const installActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const hookCallActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const signalSendActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export declare const signalInboxActionDescriptor: {
+    id: string;
+    kind: "external/action";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+//# sourceMappingURL=action-descriptors.d.ts.map

package/dist/tools/unified/action-descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-descriptors.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/action-descriptors.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;CAE3C,CAAC;AACF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;CAE1C,CAAC;AACF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;CAE1C,CAAC;AACF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;CAEzC,CAAC;AACF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;CAEnC,CAAC;AACF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;CAEpC,CAAC;AACF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;CAEtC,CAAC;AACF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;CAEvC,CAAC"}

package/dist/tools/unified/action-descriptors.js

@@ -0,0 +1,10 @@
+import { createExternalActionDescriptor } from "./runtime.js";
+export const fileAccessTrackActionDescriptor = createExternalActionDescriptor('file-access-track', 'Track file access', 'Record a file read or write for the active session');
+export const fileAccessListActionDescriptor = createExternalActionDescriptor('file-access-list', 'List file access', 'List session file-access history');
+export const contextSummaryActionDescriptor = createExternalActionDescriptor('context-summary', 'Context summary', 'Generate a context-preservation summary');
+export const hookGeneratorActionDescriptor = createExternalActionDescriptor('hook-generator', 'Generate hooks', 'Generate integration hooks for a registered external host');
+export const installActionDescriptor = createExternalActionDescriptor('install', 'Install hooks', 'Install integration hooks for a registered external host');
+export const hookCallActionDescriptor = createExternalActionDescriptor('hook-call', 'Call hook', 'Relay a native host lifecycle event into the runtime');
+export const signalSendActionDescriptor = createExternalActionDescriptor('signal-send', 'Send signal', 'Send an ephemeral message to another active agent');
+export const signalInboxActionDescriptor = createExternalActionDescriptor('signal-inbox', 'Signal inbox', 'Read ephemeral messages addressed to the active agent');
+//# sourceMappingURL=action-descriptors.js.map

package/dist/tools/unified/action-descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-descriptors.js","sourceRoot":"","sources":["../../../src/tools/unified/action-descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,CAAC,MAAM,+BAA+B,GAAG,8BAA8B,CAC5E,mBAAmB,EAAE,mBAAmB,EAAE,oDAAoD,CAC9F,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,8BAA8B,CAC3E,kBAAkB,EAAE,kBAAkB,EAAE,kCAAkC,CAC1E,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,8BAA8B,CAC3E,iBAAiB,EAAE,iBAAiB,EAAE,yCAAyC,CAC/E,CAAC;AACF,MAAM,CAAC,MAAM,6BAA6B,GAAG,8BAA8B,CAC1E,gBAAgB,EAAE,gBAAgB,EAAE,2DAA2D,CAC/F,CAAC;AACF,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CACpE,SAAS,EAAE,eAAe,EAAE,0DAA0D,CACtF,CAAC;AACF,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CACrE,WAAW,EAAE,WAAW,EAAE,sDAAsD,CAChF,CAAC;AACF,MAAM,CAAC,MAAM,0BAA0B,GAAG,8BAA8B,CACvE,aAAa,EAAE,aAAa,EAAE,mDAAmD,CACjF,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,8BAA8B,CACxE,cAAc,EAAE,cAAc,EAAE,uDAAuD,CACvF,CAAC"}

package/dist/tools/unified/action-input.d.ts

@@ -0,0 +1,7 @@
+import type { z } from 'zod/v4';
+import type { ExternalInput } from './schemas.ts';
+/** One guarded schema admission for the envelope and each action's fields. */
+export declare function parseExternalActionInput<TSchema extends z.ZodType<{
+    action: string;
+}>>(schema: TSchema, input: ExternalInput): z.output<TSchema>;
+//# sourceMappingURL=action-input.d.ts.map

package/dist/tools/unified/action-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-input.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/action-input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,EACrF,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,aAAa,GAClB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAQnB"}

package/dist/tools/unified/action-input.js

@@ -0,0 +1,13 @@
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+/** One guarded schema admission for the envelope and each action's fields. */
+export function parseExternalActionInput(schema, input) {
+    try {
+        return schema.parse(input);
+    }
+    catch (error) {
+        throw new CapabilityError('The external action input is invalid.', 'INVALID_INPUT', {
+            reason: 'external-action-input-invalid', cause: CaughtFailureSchema.parse(error)
+        });
+    }
+}
+//# sourceMappingURL=action-input.js.map

package/dist/tools/unified/action-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-input.js","sourceRoot":"","sources":["../../../src/tools/unified/action-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI3E,8EAA8E;AAC9E,MAAM,UAAU,wBAAwB,CACvC,MAAe,EACf,KAAoB;IAEpB,IAAI,CAAC;QACJ,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,eAAe,CAAC,uCAAuC,EAAE,eAAe,EAAE;YACnF,MAAM,EAAE,+BAA+B,EAAE,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC;SAChF,CAAC,CAAC;IACJ,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { ExternalActionImplementation } from './runtime.ts';
+export declare const fileAccessTrackAction: ExternalActionImplementation;
+export declare const fileAccessListAction: ExternalActionImplementation;
+export declare const contextSummaryAction: ExternalActionImplementation;
+export declare const hookGeneratorAction: ExternalActionImplementation;
+export declare const installAction: ExternalActionImplementation;
+export declare const hookCallAction: ExternalActionImplementation;
+export declare const signalSendAction: ExternalActionImplementation;
+export declare const signalInboxAction: ExternalActionImplementation;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/tools/unified/actions.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAoBjE,eAAO,MAAM,qBAAqB,8BAGjC,CAAC;AACF,eAAO,MAAM,oBAAoB,8BAGhC,CAAC;AACF,eAAO,MAAM,oBAAoB,8BAGhC,CAAC;AACF,eAAO,MAAM,mBAAmB,8BAG/B,CAAC;AACF,eAAO,MAAM,aAAa,8BAGzB,CAAC;AACF,eAAO,MAAM,cAAc,8BAG1B,CAAC;AACF,eAAO,MAAM,gBAAgB,8BAG5B,CAAC;AACF,eAAO,MAAM,iBAAiB,8BAG7B,CAAC"}