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

package/dist/harness/prompts/index.d.ts

@@ -0,0 +1,113 @@
+/** The harness prompts, as `prompts/manifest` descriptors. */
+export declare const externalHarnessPromptDescriptors: {
+    id: string;
+    kind: "prompts/manifest";
+    owner: string;
+    manifest: {
+        id: string;
+        version: string;
+        name: string;
+        description: string;
+        type: "system" | "workflow" | "specialist" | "tool" | "extraction";
+        tags: string[];
+        scope: "user" | "shared" | "builtin" | "project";
+        isPublic: boolean;
+        content: string;
+        generator: "static" | "template" | "dynamic";
+        category?: "custom" | "development" | "generation" | "extraction" | "knowledge" | "chat" | "analysis" | "validation" | undefined;
+        ownerId?: string | undefined;
+        projectId?: string | undefined;
+        sections?: {
+            key: string;
+            title: string;
+            content: string;
+            order: number;
+            collapsible: boolean;
+            conditional?: string | undefined;
+        }[] | undefined;
+        contentPath?: string | undefined;
+        tools?: string[] | undefined;
+        contextRequired?: string[] | undefined;
+        modelConfig?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+            stopSequences?: string[] | undefined;
+        } | undefined;
+        knowledgeBaseIds?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        composedWith?: string[] | undefined;
+        inject?: "tools"[] | undefined;
+        arguments?: {
+            name: string;
+            description: string;
+            type: "string" | "number" | "boolean" | "file" | "text" | "select" | "json" | "multiselect";
+            required: boolean;
+            default?: unknown;
+            options?: {
+                label: string;
+                value: string;
+                description?: string | undefined;
+            }[] | undefined;
+            validation?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        templateEngine?: "handlebars" | "mustache" | "native" | undefined;
+        transform?: {
+            inputSchema?: Record<string, unknown> | undefined;
+            transformPath?: string | undefined;
+            transformSpread?: {
+                spreadFrom?: ("user" | "data" | "project" | "session")[] | undefined;
+                assigns?: Record<string, {
+                    literal: import("@vibesdotdev/kernel/bootstrap").JsonValue;
+                } | {
+                    path: string;
+                }> | undefined;
+            } | undefined;
+        } | undefined;
+        versions?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        }[] | undefined;
+        currentVersion?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        } | undefined;
+        metadata?: {
+            author?: string | undefined;
+            license?: string | undefined;
+            source?: string | undefined;
+            related?: string[] | undefined;
+            custom?: Record<string, unknown> | undefined;
+        } | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+    };
+    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=index.d.ts.map

package/dist/harness/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/harness/prompts/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAK9D,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAiD,CAAC"}

package/dist/harness/prompts/index.js

@@ -0,0 +1,5 @@
+/** The harness prompts, as `prompts/manifest` descriptors. */
+import staticBriefingNotePrompt from "./static-briefing-note.prompt.descriptor.js";
+import systemPromptPrompt from "./system-prompt.prompt.descriptor.js";
+export const externalHarnessPromptDescriptors = [systemPromptPrompt, staticBriefingNotePrompt];
+//# sourceMappingURL=index.js.map

package/dist/harness/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harness/prompts/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,wBAAwB,MAAM,6CAA6C,CAAC;AACnF,OAAO,kBAAkB,MAAM,sCAAsC,CAAC;AAEtE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,CAAC"}

package/dist/harness/prompts/static-briefing-note.prompt.descriptor.d.ts

@@ -0,0 +1,114 @@
+/** The host note in the static briefing baked into files, which names no tools. */
+declare const _default: {
+    id: string;
+    kind: "prompts/manifest";
+    owner: string;
+    manifest: {
+        id: string;
+        version: string;
+        name: string;
+        description: string;
+        type: "system" | "workflow" | "specialist" | "tool" | "extraction";
+        tags: string[];
+        scope: "user" | "shared" | "builtin" | "project";
+        isPublic: boolean;
+        content: string;
+        generator: "static" | "template" | "dynamic";
+        category?: "custom" | "development" | "generation" | "extraction" | "knowledge" | "chat" | "analysis" | "validation" | undefined;
+        ownerId?: string | undefined;
+        projectId?: string | undefined;
+        sections?: {
+            key: string;
+            title: string;
+            content: string;
+            order: number;
+            collapsible: boolean;
+            conditional?: string | undefined;
+        }[] | undefined;
+        contentPath?: string | undefined;
+        tools?: string[] | undefined;
+        contextRequired?: string[] | undefined;
+        modelConfig?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+            stopSequences?: string[] | undefined;
+        } | undefined;
+        knowledgeBaseIds?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        composedWith?: string[] | undefined;
+        inject?: "tools"[] | undefined;
+        arguments?: {
+            name: string;
+            description: string;
+            type: "string" | "number" | "boolean" | "file" | "text" | "select" | "json" | "multiselect";
+            required: boolean;
+            default?: unknown;
+            options?: {
+                label: string;
+                value: string;
+                description?: string | undefined;
+            }[] | undefined;
+            validation?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        templateEngine?: "handlebars" | "mustache" | "native" | undefined;
+        transform?: {
+            inputSchema?: Record<string, unknown> | undefined;
+            transformPath?: string | undefined;
+            transformSpread?: {
+                spreadFrom?: ("user" | "data" | "project" | "session")[] | undefined;
+                assigns?: Record<string, {
+                    literal: import("@vibesdotdev/kernel/bootstrap").JsonValue;
+                } | {
+                    path: string;
+                }> | undefined;
+            } | undefined;
+        } | undefined;
+        versions?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        }[] | undefined;
+        currentVersion?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        } | undefined;
+        metadata?: {
+            author?: string | undefined;
+            license?: string | undefined;
+            source?: string | undefined;
+            related?: string[] | undefined;
+            custom?: Record<string, unknown> | undefined;
+        } | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+    };
+    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 default _default;
+//# sourceMappingURL=static-briefing-note.prompt.descriptor.d.ts.map

package/dist/harness/prompts/static-briefing-note.prompt.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-briefing-note.prompt.descriptor.d.ts","sourceRoot":"","sources":["../../../src/harness/prompts/static-briefing-note.prompt.descriptor.ts"],"names":[],"mappings":"AAEA,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACnF,wBAa0B"}

package/dist/harness/prompts/static-briefing-note.prompt.descriptor.js

@@ -0,0 +1,17 @@
+import { definePromptManifestDescriptor } from '@vibesdotdev/ai-schemas';
+/** The host note in the static briefing baked into files, which names no tools. */
+export default definePromptManifestDescriptor({
+    id: 'external.harness.static-briefing-note',
+    version: '1.0.0',
+    name: 'Harness static briefing note',
+    description: 'Note for baked harness prompts: find tools by capability through the projected discovery tools.',
+    type: 'system',
+    category: 'development',
+    tags: ['external', 'harness'],
+    scope: 'builtin',
+    isPublic: false,
+    generator: 'static',
+    content: `Start with the projected search and discovery tools to find the right tool
+by capability, then call it with its documented input.`
+}, { owner: 'external' });
+//# sourceMappingURL=static-briefing-note.prompt.descriptor.js.map

package/dist/harness/prompts/static-briefing-note.prompt.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-briefing-note.prompt.descriptor.js","sourceRoot":"","sources":["../../../src/harness/prompts/static-briefing-note.prompt.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,mFAAmF;AACnF,eAAe,8BAA8B,CAAC;IAC7C,EAAE,EAAE,uCAAuC;IAC3C,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,8BAA8B;IACpC,WAAW,EAAE,iGAAiG;IAC9G,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IAC7B,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE;uDAC6C;CACtD,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC"}

package/dist/harness/prompts/system-prompt.prompt.descriptor.d.ts

@@ -0,0 +1,114 @@
+/** The harness system prompt every projected host model starts from; the tool bullets are the host's registered names. */
+declare const _default: {
+    id: string;
+    kind: "prompts/manifest";
+    owner: string;
+    manifest: {
+        id: string;
+        version: string;
+        name: string;
+        description: string;
+        type: "system" | "workflow" | "specialist" | "tool" | "extraction";
+        tags: string[];
+        scope: "user" | "shared" | "builtin" | "project";
+        isPublic: boolean;
+        content: string;
+        generator: "static" | "template" | "dynamic";
+        category?: "custom" | "development" | "generation" | "extraction" | "knowledge" | "chat" | "analysis" | "validation" | undefined;
+        ownerId?: string | undefined;
+        projectId?: string | undefined;
+        sections?: {
+            key: string;
+            title: string;
+            content: string;
+            order: number;
+            collapsible: boolean;
+            conditional?: string | undefined;
+        }[] | undefined;
+        contentPath?: string | undefined;
+        tools?: string[] | undefined;
+        contextRequired?: string[] | undefined;
+        modelConfig?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+            stopSequences?: string[] | undefined;
+        } | undefined;
+        knowledgeBaseIds?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        composedWith?: string[] | undefined;
+        inject?: "tools"[] | undefined;
+        arguments?: {
+            name: string;
+            description: string;
+            type: "string" | "number" | "boolean" | "file" | "text" | "select" | "json" | "multiselect";
+            required: boolean;
+            default?: unknown;
+            options?: {
+                label: string;
+                value: string;
+                description?: string | undefined;
+            }[] | undefined;
+            validation?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        templateEngine?: "handlebars" | "mustache" | "native" | undefined;
+        transform?: {
+            inputSchema?: Record<string, unknown> | undefined;
+            transformPath?: string | undefined;
+            transformSpread?: {
+                spreadFrom?: ("user" | "data" | "project" | "session")[] | undefined;
+                assigns?: Record<string, {
+                    literal: import("@vibesdotdev/kernel/bootstrap").JsonValue;
+                } | {
+                    path: string;
+                }> | undefined;
+            } | undefined;
+        } | undefined;
+        versions?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        }[] | undefined;
+        currentVersion?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        } | undefined;
+        metadata?: {
+            author?: string | undefined;
+            license?: string | undefined;
+            source?: string | undefined;
+            related?: string[] | undefined;
+            custom?: Record<string, unknown> | undefined;
+        } | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+    };
+    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 default _default;
+//# sourceMappingURL=system-prompt.prompt.descriptor.d.ts.map

package/dist/harness/prompts/system-prompt.prompt.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.prompt.descriptor.d.ts","sourceRoot":"","sources":["../../../src/harness/prompts/system-prompt.prompt.descriptor.ts"],"names":[],"mappings":"AAEA,0HAA0H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAC1H,wBA+B0B"}

package/dist/harness/prompts/system-prompt.prompt.descriptor.js

@@ -0,0 +1,35 @@
+import { definePromptManifestDescriptor } from '@vibesdotdev/ai-schemas';
+/** The harness system prompt every projected host model starts from; the tool bullets are the host's registered names. */
+export default definePromptManifestDescriptor({
+    id: 'external.harness.system-prompt',
+    version: '1.0.0',
+    name: 'Harness system prompt',
+    description: 'System prompt for a Vibes-projected agent in an external host: provenance, namespace, workspace root, registered tools.',
+    type: 'system',
+    category: 'development',
+    tags: ['external', 'harness', 'system-prompt'],
+    scope: 'builtin',
+    isPublic: false,
+    generator: 'template',
+    content: `{{provenanceMarker}} {{provenance}}.
+
+You are a Vibes-projected agent. Host built-in tools are disabled where this
+harness allows it. Use {{namespace}} tools for work.{{#if workspaceRoot}}
+
+Your workspace root is \`{{workspaceRoot}}\`. Relative paths in tool calls resolve from there.{{/if}}
+
+{{toolLines}}- Prefer concrete outputs. Verify with tools before claiming.{{#if note}}
+
+{{note}}{{/if}}
+
+If a requested operation is unavailable, say the constraint and the next viable action.`,
+    arguments: [
+        { name: 'provenanceMarker', description: 'First-line marker older installs check for', type: 'string', required: true },
+        { name: 'provenance', description: 'Where this prompt was projected from', type: 'string', required: true },
+        { name: 'namespace', description: 'Namespace label the model should expect, e.g. vibes_*', type: 'string', required: true },
+        { name: 'workspaceRoot', description: 'Workspace root relative tool paths resolve from, when known', type: 'string' },
+        { name: 'toolLines', description: 'One bullet line per callable tool, each ending in a newline', type: 'text' },
+        { name: 'note', description: 'Host-specific caveat after the tool list', type: 'text' }
+    ]
+}, { owner: 'external' });
+//# sourceMappingURL=system-prompt.prompt.descriptor.js.map

package/dist/harness/prompts/system-prompt.prompt.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.prompt.descriptor.js","sourceRoot":"","sources":["../../../src/harness/prompts/system-prompt.prompt.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,0HAA0H;AAC1H,eAAe,8BAA8B,CAAC;IAC7C,EAAE,EAAE,gCAAgC;IACpC,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,yHAAyH;IACtI,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,aAAa;IACvB,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC;IAC9C,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE;;;;;;;;;;;wFAW8E;IACvF,SAAS,EAAE;QACV,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,4CAA4C,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACvH,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,sCAAsC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3G,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,uDAAuD,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3H,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,6DAA6D,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrH,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,6DAA6D,EAAE,IAAI,EAAE,MAAM,EAAE;QAC/G,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0CAA0C,EAAE,IAAI,EAAE,MAAM,EAAE;KACvF;CACD,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC"}

package/dist/harness/role-prompt.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The agent role prompt: the runtime's `prompts/manifest` descriptors an agent
+ * host projects into its system prompt. A host names the manifests it wants
+ * (short id or full `prompts.manifest.*` id); each renders through the same
+ * `renderPromptManifest` the native prompt surface uses, so a host session and
+ * `vibes prompts show` read one identity. Manifests that are absent, disabled,
+ * or render empty contribute nothing — the host's own prompt stands alone.
+ */
+import type { VibesAgentHost } from './agent-host.ts';
+/** Render the named prompt manifests, joined by blank lines; empty when none match. */
+export declare function renderAgentRolePrompt(host: Pick<VibesAgentHost, 'prompts'>, ids?: readonly string[]): string;
+//# sourceMappingURL=role-prompt.d.ts.map

package/dist/harness/role-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-prompt.d.ts","sourceRoot":"","sources":["../../src/harness/role-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,uFAAuF;AACvF,wBAAgB,qBAAqB,CACpC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EACrC,GAAG,GAAE,SAAS,MAAM,EAAkB,GACpC,MAAM,CAUR"}

package/dist/harness/role-prompt.js

@@ -0,0 +1,24 @@
+/**
+ * The agent role prompt: the runtime's `prompts/manifest` descriptors an agent
+ * host projects into its system prompt. A host names the manifests it wants
+ * (short id or full `prompts.manifest.*` id); each renders through the same
+ * `renderPromptManifest` the native prompt surface uses, so a host session and
+ * `vibes prompts show` read one identity. Manifests that are absent, disabled,
+ * or render empty contribute nothing — the host's own prompt stands alone.
+ */
+import { renderPromptManifest } from '@vibesdotdev/ai-schemas';
+/** Render the named prompt manifests, joined by blank lines; empty when none match. */
+export function renderAgentRolePrompt(host, ids = ['developer']) {
+    const wanted = new Set(ids);
+    const parts = [];
+    for (const descriptor of host.prompts()) {
+        const shortId = descriptor.id.replace(/^prompts\.manifest\./, '');
+        if (!wanted.has(descriptor.id) && !wanted.has(shortId))
+            continue;
+        const text = renderPromptManifest(descriptor.manifest, {}).trim();
+        if (text)
+            parts.push(text);
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=role-prompt.js.map

package/dist/harness/role-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-prompt.js","sourceRoot":"","sources":["../../src/harness/role-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CACpC,IAAqC,EACrC,MAAyB,CAAC,WAAW,CAAC;IAEtC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,SAAS;QACjE,MAAM,IAAI,GAAG,oBAAoB,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/dist/harness/runtime-transport.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Warm runtime client transport for external host projections.
+ *
+ * Connects to the per-workspace runtime socket via @vibesdotdev/kernel-rpc/unix.
+ * A tool call cannot spawn a process. The transport locates nothing: the
+ * host that constructs it hands in the socket (named by the runtime daemon's
+ * socket-path owner) and the workspace it serves.
+ *
+ * Everything the socket answers is untrusted: answers are schema-checked, and
+ * failure text reaching a host tool is a typed refusal's message or value-free
+ * facts, never a raw error message.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, type CaughtFailure } from '@vibesdotdev/kernel';
+import type { RpcSocketRuntime } from '@vibesdotdev/kernel-rpc/unix';
+import { type RunVibesOptions, type RunVibesResult } from '@vibesdotdev/cli-contracts';
+/** The reason a handed runtime socket could not be used (stale, refused, unreadable). */
+export declare const RUNTIME_SOCKET_UNAVAILABLE = "runtime-socket-unavailable";
+/** Whether `failure` is a transport's typed "the handed socket is unavailable". */
+export declare function isRuntimeSocketUnavailable(failure: CaughtFailure): failure is CapabilityError;
+/** A JSON value as the runtime socket carries it. */
+declare const WireJsonSchema: z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+export type WireJson = z.output<typeof WireJsonSchema>;
+/** A tool invocation request sent over the runtime socket. */
+export interface RuntimeInvokeRequest {
+    readonly type: 'runtime-command';
+    readonly invokeType: 'tool';
+    readonly id: string;
+    readonly params: WireJson;
+    readonly caller: 'host-projection';
+    readonly timeout?: number;
+}
+/** A registry query sent over the runtime socket. */
+export interface RuntimeQueryRequest {
+    readonly kind: string;
+}
+/** The runtime socket's root methods a host projection calls. */
+export interface RuntimeSocketRoot {
+    invoke?: (payload: RuntimeInvokeRequest) => Promise<WireJson>;
+    query?: (payload: RuntimeQueryRequest) => Promise<WireJson>;
+}
+export type RuntimeTransportConnection = {
+    conn: {
+        close: () => Promise<void>;
+        closed?: Promise<void>;
+    };
+    root: RuntimeSocketRoot;
+};
+export type RuntimeTransportOptions = {
+    /** The runtime daemon socket for `workspaceRoot`, as its socket-path owner names it. */
+    socketPath: string;
+    /** The workspace this host serves; `run` refuses a command for any other cwd. */
+    workspaceRoot: string;
+    /**
+     * The runtime whose `runtime/socket` service opens the connection (the
+     * host's own runtime). Required unless `connect` is injected.
+     */
+    runtime?: RpcSocketRuntime;
+    /** Injected connect function for testing or custom transports */
+    connect?: (socketPath: string) => Promise<RuntimeTransportConnection>;
+    signal?: AbortSignal;
+};
+/** One `tools/tool` descriptor as the runtime catalog answers it. */
+declare const RuntimeToolDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+    schemas: z.ZodOptional<z.ZodObject<{
+        input: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+        output: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type RuntimeToolDescriptor = z.output<typeof RuntimeToolDescriptorSchema>;
+/** Connect to a runtime socket through `runtime`'s socket service and wire its root. */
+export declare function connectRuntimeSocket(socketPath: string, runtime: RpcSocketRuntime): Promise<RuntimeTransportConnection>;
+/** A socket-backed runner spawns nothing, so it needs no host env: options are all optional. */
+export type RuntimeRunFn = (argv: string[], options?: Partial<RunVibesOptions>) => Promise<RunVibesResult>;
+export type RuntimeTransport = {
+    getConnection: () => Promise<RuntimeTransportConnection | null>;
+    fetchToolCatalog: () => Promise<RuntimeToolDescriptor[] | null>;
+    invalidateToolCatalog: () => void;
+    run: RuntimeRunFn;
+    dispose: () => Promise<void>;
+};
+/** One host owns one workspace, connection and catalog. Dispose never closes another handle. */
+export declare function createRuntimeTransport(options: RuntimeTransportOptions): RuntimeTransport;
+export {};
+//# sourceMappingURL=runtime-transport.d.ts.map

package/dist/harness/runtime-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-transport.d.ts","sourceRoot":"","sources":["../../src/harness/runtime-transport.ts"],"names":[],"mappings":"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"}