@zihanw/pi-forge 0.4.1 → 0.5.0

package/dist/stack-migration.d.ts

@@ -24,6 +24,12 @@ export interface PromptStackMigrationReport {
     errors: number;
     deletedLegacy: number;
 }
+/**
+ * Orchestrate the legacy `.pi/prompt-stacks` -> `.pi/forge/prompt-stacks`
+ * migration. All filesystem IO (raw byte-preserving reads, copies, deletes)
+ * lives in the prompt-stack repository; this command owns only reporting,
+ * overwrite policy, dry-run, and deletion ordering.
+ */
 export declare function migrateLegacyPromptStacks(cwd: string, options?: PromptStackMigrationOptions): PromptStackMigrationReport;
 export declare function renderMigrationReport(report: PromptStackMigrationReport): string;
 //# sourceMappingURL=stack-migration.d.ts.map

package/dist/stack-migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack-migration.d.ts","sourceRoot":"","sources":["../src/stack-migration.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,2BAA2B;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC,GAAG,0BAA0B,CAqF5H;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAsChF"}
+{"version":3,"file":"stack-migration.d.ts","sourceRoot":"","sources":["../src/stack-migration.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,2BAA2B;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC,GAAG,0BAA0B,CAgF5H;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM,CAsChF"}

package/dist/stack-migration.js

@@ -1,8 +1,14 @@
-import { copyFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { legacyPromptStacksDir, promptStacksDir } from "./storage.js";
+import { join } from "node:path";
+import { promptStacksDir } from "./storage.js";
+import { copyLegacyPromptStackFile, deleteLegacyPromptStackFile, readLegacyPromptStackSources, } from "./repositories/prompt-stack.js";
+/**
+ * Orchestrate the legacy `.pi/prompt-stacks` -> `.pi/forge/prompt-stacks`
+ * migration. All filesystem IO (raw byte-preserving reads, copies, deletes)
+ * lives in the prompt-stack repository; this command owns only reporting,
+ * overwrite policy, dry-run, and deletion ordering.
+ */
 export function migrateLegacyPromptStacks(cwd, options = {}) {
-    const sourceDir = legacyPromptStacksDir(cwd);
+    const sourceDir = join(cwd, ".pi", "prompt-stacks");
     const targetDir = promptStacksDir(cwd);
     const report = {
         sourceDir,
@@ -17,32 +23,25 @@ export function migrateLegacyPromptStacks(cwd, options = {}) {
         errors: 0,
         deletedLegacy: 0,
     };
-    if (!existsSync(sourceDir))
-        return report;
-    let entries;
+    let sources;
     try {
-        entries = readdirSync(sourceDir).filter((name) => name.endsWith(".json")).sort();
+        sources = readLegacyPromptStackSources(cwd);
     }
-    catch (error) {
-        report.files.push({
-            name: "(legacy directory)",
-            sourcePath: sourceDir,
-            targetPath: targetDir,
-            action: "error",
-            reason: error instanceof Error ? error.message : String(error),
-            deleteLegacy: false,
-        });
-        report.errors++;
-        return report;
+    catch {
+        sources = [];
     }
-    for (const name of entries) {
-        const sourcePath = join(sourceDir, name);
-        const targetPath = join(targetDir, name);
-        const targetExists = existsSync(targetPath);
-        if (targetExists && !report.overwrite) {
+    if (sources.length === 0)
+        return report;
+    for (const source of sources) {
+        const targetPath = join(targetDir, source.name);
+        const copy = copyLegacyPromptStackFile(cwd, source.sourcePath, targetPath, {
+            overwrite: report.overwrite,
+            dryRun: report.dryRun,
+        });
+        if (!copy.ok && copy.reason === "exists") {
             report.files.push({
-                name,
-                sourcePath,
+                name: source.name,
+                sourcePath: source.sourcePath,
                 targetPath,
                 action: "skip",
                 reason: "target already exists",
@@ -51,39 +50,37 @@ export function migrateLegacyPromptStacks(cwd, options = {}) {
             report.skipped++;
             continue;
         }
-        const action = targetExists ? "overwrite" : "copy";
-        try {
-            if (!report.dryRun) {
-                mkdirSync(dirname(targetPath), { recursive: true });
-                copyFileSync(sourcePath, targetPath);
-                if (report.deleteLegacy) {
-                    unlinkSync(sourcePath);
-                    report.deletedLegacy++;
-                }
-            }
-            if (action === "overwrite")
-                report.overwritten++;
-            else
-                report.copied++;
-            report.files.push({
-                name,
-                sourcePath,
-                targetPath,
-                action,
-                deleteLegacy: report.deleteLegacy,
-            });
-        }
-        catch (error) {
+        if (!copy.ok) {
             report.files.push({
-                name,
-                sourcePath,
+                name: source.name,
+                sourcePath: source.sourcePath,
                 targetPath,
                 action: "error",
-                reason: error instanceof Error ? error.message : String(error),
+                reason: copy.error,
                 deleteLegacy: false,
             });
             report.errors++;
+            continue;
         }
+        if (copy.action === "overwrite")
+            report.overwritten++;
+        else
+            report.copied++;
+        let deletedLegacy = false;
+        if (report.deleteLegacy) {
+            const deleted = deleteLegacyPromptStackFile(cwd, source.sourcePath, { dryRun: report.dryRun });
+            if (deleted.ok) {
+                deletedLegacy = true;
+                report.deletedLegacy++;
+            }
+        }
+        report.files.push({
+            name: source.name,
+            sourcePath: source.sourcePath,
+            targetPath,
+            action: copy.action,
+            deleteLegacy: deletedLegacy,
+        });
     }
     return report;
 }

package/dist/stack-migration.js.map

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

package/dist/subagent/fingerprints.d.ts

@@ -0,0 +1,24 @@
+import type { AgentProfile } from "../agent-profile.ts";
+import type { PromptStack } from "../types.ts";
+/**
+ * Forge-owned canonical JSON + `sha256:v1` fingerprints.
+ *
+ * Vendored from @zihanw/pi-subagent-runtime's canonical implementation so the
+ * main package carries no runtime dependency. The algorithm is byte-for-byte
+ * identical (key-sorted plain objects, undefined properties omitted, finite
+ * numbers only, -0 normalized, no cycles/sparse arrays/non-plain objects), so
+ * fingerprints the host issues into profile snapshots stay comparable with
+ * values the optional package recomputes through the runtime. Golden vectors
+ * are pinned in tests/subagent-host.test.ts.
+ *
+ * The host never computes conversation/execution fingerprints; those are
+ * issued by the runtime during plan sealing in the optional package.
+ */
+export declare const SUBAGENT_FINGERPRINT_PREFIX: "sha256:v1:";
+export type SubagentFingerprint = `${typeof SUBAGENT_FINGERPRINT_PREFIX}${string}`;
+export declare function canonicalSubagentJson(value: unknown): string;
+export declare function subagentFingerprint(value: unknown): SubagentFingerprint;
+/** Host-owned source provenance: profile and prompt-stack content fingerprints. */
+export declare function subagentSourceProfileFingerprint(profile: AgentProfile): SubagentFingerprint;
+export declare function subagentPromptStackFingerprint(stack: PromptStack): SubagentFingerprint;
+//# sourceMappingURL=fingerprints.d.ts.map

package/dist/subagent/fingerprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprints.d.ts","sourceRoot":"","sources":["../../src/subagent/fingerprints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,2BAA2B,EAAG,YAAqB,CAAC;AACjE,MAAM,MAAM,mBAAmB,GAAG,GAAG,OAAO,2BAA2B,GAAG,MAAM,EAAE,CAAC;AAEnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAKvE;AAED,mFAAmF;AACnF,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,YAAY,GAAG,mBAAmB,CAE3F;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,WAAW,GAAG,mBAAmB,CAEtF"}

package/dist/subagent/fingerprints.js

@@ -0,0 +1,81 @@
+import { createHash } from "node:crypto";
+/**
+ * Forge-owned canonical JSON + `sha256:v1` fingerprints.
+ *
+ * Vendored from @zihanw/pi-subagent-runtime's canonical implementation so the
+ * main package carries no runtime dependency. The algorithm is byte-for-byte
+ * identical (key-sorted plain objects, undefined properties omitted, finite
+ * numbers only, -0 normalized, no cycles/sparse arrays/non-plain objects), so
+ * fingerprints the host issues into profile snapshots stay comparable with
+ * values the optional package recomputes through the runtime. Golden vectors
+ * are pinned in tests/subagent-host.test.ts.
+ *
+ * The host never computes conversation/execution fingerprints; those are
+ * issued by the runtime during plan sealing in the optional package.
+ */
+export const SUBAGENT_FINGERPRINT_PREFIX = "sha256:v1:";
+export function canonicalSubagentJson(value) {
+    return canonicalize(value, "$", new Set());
+}
+export function subagentFingerprint(value) {
+    const digest = createHash("sha256")
+        .update(canonicalSubagentJson(value))
+        .digest("hex");
+    return `${SUBAGENT_FINGERPRINT_PREFIX}${digest}`;
+}
+/** Host-owned source provenance: profile and prompt-stack content fingerprints. */
+export function subagentSourceProfileFingerprint(profile) {
+    return subagentFingerprint(profile);
+}
+export function subagentPromptStackFingerprint(stack) {
+    return subagentFingerprint(stack);
+}
+function canonicalize(value, path, ancestors) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string" || typeof value === "boolean") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new TypeError(`Cannot fingerprint non-finite number at ${path}.`);
+        }
+        return JSON.stringify(Object.is(value, -0) ? 0 : value);
+    }
+    if (typeof value !== "object" || value === undefined) {
+        throw new TypeError(`Cannot fingerprint ${typeof value} at ${path}.`);
+    }
+    if (ancestors.has(value)) {
+        throw new TypeError(`Cannot fingerprint cyclic value at ${path}.`);
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            const items = [];
+            for (let index = 0; index < value.length; index += 1) {
+                if (!Object.hasOwn(value, index)) {
+                    throw new TypeError(`Cannot fingerprint sparse array item at ${path}[${index}].`);
+                }
+                items.push(canonicalize(value[index], `${path}[${index}]`, ancestors));
+            }
+            return `[${items.join(",")}]`;
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError(`Cannot fingerprint non-plain object at ${path}.`);
+        }
+        const record = value;
+        const keys = Object.keys(record)
+            .filter((key) => record[key] !== undefined)
+            .sort();
+        const properties = keys.map((key) => {
+            const property = canonicalize(record[key], `${path}.${key}`, ancestors);
+            return `${JSON.stringify(key)}:${property}`;
+        });
+        return `{${properties.join(",")}}`;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+//# sourceMappingURL=fingerprints.js.map

package/dist/subagent/fingerprints.js.map

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

package/dist/subagent/host-port.d.ts

@@ -0,0 +1,296 @@
+import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { SubagentFingerprint } from "./fingerprints.ts";
+/**
+ * Cross-extension Forge host port v1 over the Pi event bus.
+ *
+ * This is the in-process RPC contract used by the optional subagent package to
+ * discover the active main pi-forge host and invoke its three minimal
+ * operations (discovery, profile listing, and prompt preparation). Messages
+ * are plain, recursively validated, JSON-compatible data only — no functions,
+ * live contexts, or internal registries cross the bus. The port itself is not
+ * a trust boundary.
+ *
+ * Ownership: the main pi-forge host owns profiles, stacks, and prompt
+ * compilation. The optional package sends resource selectors + task + backend
+ * facts and receives immutable preparation artifacts back.
+ */
+export declare const FORGE_HOST_PORT_VERSION = 1;
+export declare const FORGE_HOST_PORT_NAMESPACE = "@zihanw/pi-forge/host/v1";
+export declare const FORGE_HOST_PORT_OPERATIONS: readonly ["listProfiles", "resolveProfile", "prepare"];
+export type ForgeHostPortOperation = (typeof FORGE_HOST_PORT_OPERATIONS)[number];
+export declare const FORGE_HOST_CHANNEL: {
+    readonly discover: "@zihanw/pi-forge/host/v1/discover";
+    readonly available: "@zihanw/pi-forge/host/v1/available";
+    readonly request: "@zihanw/pi-forge/host/v1/request";
+    readonly reply: "@zihanw/pi-forge/host/v1/reply";
+    readonly unavailable: "@zihanw/pi-forge/host/v1/unavailable";
+};
+export interface ForgeHostTransport {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: (data: unknown) => void): () => void;
+}
+export type ForgeHostWireMessage = {
+    type: "discover";
+    protocolVersion: number;
+    minVersion: number;
+    maxVersion: number;
+    clientId: string;
+} | {
+    type: "available";
+    hostId: string;
+    protocolVersion: number;
+    minVersion: number;
+    maxVersion: number;
+    capabilities: string[];
+    generation: number;
+} | {
+    type: "request";
+    requestId: string;
+    hostId: string;
+    generation: number;
+    operation: string;
+    payload: unknown;
+} | {
+    type: "reply";
+    requestId: string;
+    hostId: string;
+    generation: number;
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+} | {
+    type: "unavailable";
+    hostId: string;
+    generation: number;
+};
+export type ForgeHostPortResult = {
+    ok: true;
+    data: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+export interface ForgeHostOptions {
+    hostId?: string;
+    capabilities?: readonly string[];
+    minVersion?: number;
+    maxVersion?: number;
+    /** Operation handler; must never throw across the bus. */
+    handle(operation: string, payload: unknown): ForgeHostPortResult;
+}
+export interface ForgeHostConnection {
+    hostId: string;
+    protocolVersion: number;
+    capabilities: readonly string[];
+    generation: number;
+}
+export interface ForgeProfileSummary {
+    profileId: string;
+    scope: "project" | "global";
+    name?: string;
+    description?: string;
+    autoActivate?: boolean;
+    model: {
+        provider: string;
+        id: string;
+    };
+    thinkingLevel: string;
+    promptStack: string | null;
+    usable: boolean;
+    diagnostics: Array<{
+        level: string;
+        message: string;
+        field?: string;
+    }>;
+}
+export interface ForgeListProfilesResponse {
+    profiles: ForgeProfileSummary[];
+}
+/**
+ * Wire diagnostic shape for delegation resolution and preparation.
+ * Structurally compatible with the optional package's `SubagentDiagnostic`.
+ */
+export interface ForgeDelegationDiagnostic {
+    level: "error" | "warning" | "info";
+    code: string;
+    message: string;
+    path?: string;
+}
+/** Host-compiled delegation message as carried over the wire (text-only). */
+export interface ForgeDelegationMessage {
+    role: "user" | "assistant" | "custom";
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    protectedTask?: boolean;
+    source?: "prompt-stack" | "delegated-task";
+}
+export type ForgePromptDependencyKind = "macro" | "slot";
+export interface ForgePromptDependency {
+    kind: ForgePromptDependencyKind;
+    name: string;
+    identity: string;
+    source?: string;
+}
+/**
+ * Minimal structural mirror of the host-owned agent profile carried over the
+ * wire. The host owns the schema: at runtime extra fields may pass through for
+ * forward compatibility, but consumers must only rely on the fields below.
+ */
+export interface ForgeWireAgentProfile {
+    schemaVersion: 1;
+    type: string;
+    id: string;
+    name?: string;
+    description?: string;
+    autoActivate?: boolean;
+    model: {
+        provider: string;
+        id: string;
+    };
+    thinkingLevel: ThinkingLevel;
+    promptStack: string | null;
+}
+/**
+ * Minimal structural mirror of the host-owned prompt stack carried over the
+ * wire. Same forward-compat rule as ForgeWireAgentProfile.
+ */
+export interface ForgeWirePromptStack {
+    id: string;
+    tools?: {
+        allow?: string[];
+        deny?: never;
+    } | {
+        allow?: never;
+        deny?: string[];
+    };
+}
+/**
+ * Immutable host-owned profile snapshot artifact returned by `resolveProfile`
+ * and embedded in `prepare` responses. The wire schema version is shared with
+ * the optional package's `AgentProfileSnapshot` by design.
+ */
+export interface ForgeProfileSnapshot {
+    schemaVersion: 1;
+    /** Canonical scoped selector of the resolved profile (`project:<id>` or `global:<id>`). */
+    profileId: string;
+    profile: ForgeWireAgentProfile;
+    /** Canonical scoped selector of the resolved prompt stack, or null. */
+    promptStackId: string | null;
+    promptStack: ForgeWirePromptStack | null;
+    dependencies: ForgePromptDependency[];
+    profileFingerprint: SubagentFingerprint;
+    promptStackFingerprint: SubagentFingerprint | null;
+}
+export interface ForgeResolveProfileRequest {
+    profile: string;
+}
+export interface ForgeResolveProfileResponse {
+    /** Immutable host-owned AgentProfileSnapshot artifact (profile + stack + fingerprints). */
+    snapshot: ForgeProfileSnapshot;
+}
+/**
+ * Prompt-compilation access facts only — what Forge's tool negotiation reads.
+ * This intentionally is NOT the runtime `AgentRequest.access`; the optional
+ * package projects its own runtime access request onto these three facts.
+ */
+export interface ForgePromptAccessFacts {
+    level: "none" | "read-only" | "workspace-write";
+    network: "deny" | "allow";
+    allowProcess: boolean;
+}
+export interface ForgeBackendTool {
+    id: string;
+    name?: string;
+    effects?: string[];
+}
+export interface ForgeBackendFacts {
+    model: {
+        provider: string;
+        id: string;
+    };
+    thinkingLevel: string;
+    toolCatalog: ForgeBackendTool[];
+}
+export interface ForgePrepareRequest {
+    profile: string;
+    task: {
+        text: string;
+    };
+    access: ForgePromptAccessFacts;
+    backend: ForgeBackendFacts;
+}
+export interface ForgePrepareResponse {
+    profileId: string;
+    model: {
+        provider: string;
+        id: string;
+    };
+    thinkingLevel: string;
+    systemPrompt: string;
+    messages: ForgeDelegationMessage[];
+    effectiveToolIds: string[];
+    effectiveToolNames: string[];
+    diagnostics: ForgeDelegationDiagnostic[];
+    profileSnapshot: ForgeProfileSnapshot;
+    preparedAt: string;
+}
+export declare class ForgeHostPortError extends Error {
+    readonly code: "timeout" | "duplicate" | "unavailable" | "protocol" | "invalid";
+    constructor(code: ForgeHostPortError["code"], message: string);
+}
+export type ValidationResult<T = unknown> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateListProfilesRequest(value: unknown): ValidationResult<Record<string, never>>;
+export declare function validateListProfilesResponse(value: unknown): ValidationResult<ForgeListProfilesResponse>;
+export declare function validateResolveProfileRequest(value: unknown): ValidationResult<ForgeResolveProfileRequest>;
+export declare function validateResolveProfileResponse(value: unknown): ValidationResult<ForgeResolveProfileResponse>;
+export declare function validatePrepareRequest(value: unknown): ValidationResult<ForgePrepareRequest>;
+export declare function validatePrepareResponse(value: unknown): ValidationResult<ForgePrepareResponse>;
+export declare class ForgeHost {
+    private readonly transport;
+    private readonly options;
+    readonly hostId: string;
+    private generationId;
+    private started;
+    private unsubscribers;
+    constructor(transport: ForgeHostTransport, options: ForgeHostOptions);
+    get generation(): number;
+    get isLive(): boolean;
+    private availableMessage;
+    start(): void;
+    stop(): void;
+    private onDiscover;
+    private onRequest;
+}
+export interface ForgeHostClientOptions {
+    clientId?: string;
+    defaultTimeoutMs?: number;
+    /** How long after the first compatible host reply to keep collecting others before deciding. */
+    discoverSettleMs?: number;
+}
+export declare class ForgeHostClient {
+    private readonly transport;
+    readonly clientId: string;
+    private readonly defaultTimeoutMs;
+    private readonly discoverSettleMs;
+    private connectionUnsubscribe?;
+    private unavailableHandlers;
+    private activeConnection?;
+    constructor(transport: ForgeHostTransport, options?: ForgeHostClientOptions);
+    onUnavailable(handler: () => void): () => void;
+    private teardownPersistentListener;
+    private onUnavailableMessage;
+    discover(timeoutMs?: number): Promise<ForgeHostConnection>;
+    connect(connection: ForgeHostConnection): ForgeHostConnection;
+    request(connection: ForgeHostConnection, operation: string, payload: unknown, timeoutMs?: number): Promise<ForgeHostPortResult>;
+    disconnect(): void;
+    get subscriptionCount(): number;
+}
+//# sourceMappingURL=host-port.d.ts.map

package/dist/subagent/host-port.d.ts.map

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