@a5c-ai/genty-platform 5.1.1-staging.0ad6ac75ae4a

package/dist/harness/backgroundTracker.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackgroundEffectTracker = void 0;
+/**
+ * Tracks background effects that have been dispatched but not yet resolved.
+ * Supports polling, timeout checking, and collecting completed results.
+ */
+class BackgroundEffectTracker {
+    effects = new Map();
+    /**
+     * Start tracking a dispatched background effect.
+     */
+    track(entry) {
+        this.effects.set(entry.effectId, {
+            entry,
+            completed: false,
+        });
+    }
+    /**
+     * Get all currently tracked (non-completed) effects.
+     */
+    getAll() {
+        const result = [];
+        for (const tracked of this.effects.values()) {
+            if (!tracked.completed) {
+                result.push(tracked.entry);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get a tracked effect by effectId, or undefined if not found.
+     */
+    get(effectId) {
+        const tracked = this.effects.get(effectId);
+        if (!tracked || tracked.completed)
+            return undefined;
+        return tracked.entry;
+    }
+    /**
+     * Poll a background effect's status. Updates lastPolledAt.
+     * Throws if the effectId is not tracked.
+     */
+    poll(effectId) {
+        const tracked = this.effects.get(effectId);
+        if (!tracked) {
+            throw new Error(`Background effect not found: ${effectId}`);
+        }
+        const now = new Date().toISOString();
+        tracked.lastPolledAt = now;
+        return {
+            effectId,
+            state: tracked.completed ? "completed" : "running",
+            lastPolledAt: now,
+        };
+    }
+    /**
+     * Mark a background effect as completed with a result.
+     */
+    markCompleted(effectId, result) {
+        const tracked = this.effects.get(effectId);
+        if (!tracked) {
+            throw new Error(`Background effect not found: ${effectId}`);
+        }
+        tracked.completed = true;
+        tracked.result = result;
+    }
+    /**
+     * Collect and remove all completed effects from the tracker.
+     */
+    collectCompleted() {
+        const completed = [];
+        for (const [id, tracked] of this.effects.entries()) {
+            if (tracked.completed) {
+                completed.push({
+                    effectId: id,
+                    result: tracked.result,
+                });
+                this.effects.delete(id);
+            }
+        }
+        return completed;
+    }
+    /**
+     * Check all tracked effects for timeout. Effects that have exceeded their
+     * timeoutMs are marked as completed with an error.
+     */
+    checkTimeouts() {
+        const now = Date.now();
+        for (const tracked of this.effects.values()) {
+            if (tracked.completed)
+                continue;
+            const timeoutMs = tracked.entry.timeoutMs;
+            if (timeoutMs === undefined)
+                continue;
+            const dispatched = new Date(tracked.entry.dispatchedAt).getTime();
+            if (now - dispatched >= timeoutMs) {
+                tracked.completed = true;
+                tracked.result = {
+                    status: "error",
+                    error: `Background effect '${tracked.entry.effectId}' timed out after ${timeoutMs}ms`,
+                };
+            }
+        }
+    }
+}
+exports.BackgroundEffectTracker = BackgroundEffectTracker;

package/dist/harness/builtInHarness.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeBuiltInHarnessName(harnessName: string): string;
+export declare function isBuiltInHarnessName(harnessName: string): boolean;
+//# sourceMappingURL=builtInHarness.d.ts.map

package/dist/harness/builtInHarness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtInHarness.d.ts","sourceRoot":"","sources":["../../src/harness/builtInHarness.ts"],"names":[],"mappings":"AAIA,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGjE"}

package/dist/harness/builtInHarness.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeBuiltInHarnessName = normalizeBuiltInHarnessName;
+exports.isBuiltInHarnessName = isBuiltInHarnessName;
+const BUILT_IN_HARNESS_ALIASES = {
+    internal: "agent-core",
+};
+function normalizeBuiltInHarnessName(harnessName) {
+    const normalized = harnessName.trim();
+    if (!normalized) {
+        return normalized;
+    }
+    return BUILT_IN_HARNESS_ALIASES[normalized] ?? normalized;
+}
+function isBuiltInHarnessName(harnessName) {
+    const normalized = normalizeBuiltInHarnessName(harnessName);
+    return normalized === "agent-core" || normalized === "oh-my-pi";
+}

package/dist/harness/capabilityRouter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Capability-based task routing (GAP-HADAPT-001).
+ *
+ * Scores harness candidates against task requirements and selects
+ * the best match. Pure functions, no side effects.
+ */
+import type { HarnessCapability, HarnessDiscoveryResult } from "./types";
+/** What a task needs from a harness. */
+export interface TaskRequirements {
+    /** Capabilities that MUST be present (missing = disqualified). */
+    requiredCapabilities: HarnessCapability[];
+    /** Preferred model name (exact match > partial > none). */
+    preferredModel?: string;
+    /** Tools the task needs available. */
+    requiredTools: string[];
+    /** Permissions the task needs. */
+    requiredPermissions: string[];
+    /** Preferred harness name (soft preference, not hard requirement). */
+    preferredHarness?: string;
+}
+/** A harness candidate for routing. */
+export interface HarnessCandidate {
+    name: string;
+    capabilities: HarnessCapability[];
+    supportedModels: string[];
+    availableTools: string[];
+    permissions: string[];
+}
+/** Score breakdown for a single candidate. */
+export interface ScoreBreakdown {
+    capabilities: number;
+    model: number;
+    tools: number;
+    permissions: number;
+}
+/** Per-candidate score entry. */
+export interface CandidateScore {
+    name: string;
+    total: number;
+    breakdown: ScoreBreakdown;
+    disqualified: boolean;
+}
+/** Result of routing — null if no suitable candidate found. */
+export interface RoutingResult {
+    selected: HarnessCandidate;
+    score: number;
+    scoreBreakdown: ScoreBreakdown;
+    scores: CandidateScore[];
+    candidates: HarnessCandidate[];
+}
+/**
+ * Select the best harness candidate for a set of task requirements.
+ * Returns null if no candidate meets the threshold (50).
+ */
+export declare function selectHarness(requirements: Partial<TaskRequirements>, candidates: HarnessCandidate[]): RoutingResult | null;
+/**
+ * Enrich discovery results with capabilities from the known harness registry.
+ * Merges discovered capabilities with known capabilities, deduplicating.
+ */
+export declare function enrichDiscoveryWithCapabilities(discoveries: HarnessDiscoveryResult[]): HarnessDiscoveryResult[];
+interface TaskDefLike {
+    kind: string;
+    execution?: {
+        harness?: string;
+        model?: string;
+        permissions?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Build TaskRequirements from a TaskDef's execution hints and kind.
+ */
+export declare function buildTaskRequirements(taskDef: Partial<TaskDefLike>): TaskRequirements;
+export {};
+//# sourceMappingURL=capabilityRouter.d.ts.map

package/dist/harness/capabilityRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityRouter.d.ts","sourceRoot":"","sources":["../../src/harness/capabilityRouter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAQzE,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;IAC1C,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAgGD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACvC,UAAU,EAAE,gBAAgB,EAAE,GAC7B,aAAa,GAAG,IAAI,CAwCtB;AAmBD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,sBAAsB,EAAE,GACpC,sBAAsB,EAAE,CAQ1B;AAMD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,gBAAgB,CAmBlB"}

package/dist/harness/capabilityRouter.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Capability-based task routing (GAP-HADAPT-001).
+ *
+ * Scores harness candidates against task requirements and selects
+ * the best match. Pure functions, no side effects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectHarness = selectHarness;
+exports.enrichDiscoveryWithCapabilities = enrichDiscoveryWithCapabilities;
+exports.buildTaskRequirements = buildTaskRequirements;
+const types_1 = require("./types");
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+// ---------------------------------------------------------------------------
+// Scoring weights
+// ---------------------------------------------------------------------------
+const WEIGHT_CAPABILITIES = 40;
+const WEIGHT_MODEL = 25;
+const WEIGHT_TOOLS = 20;
+const WEIGHT_PERMISSIONS = 15;
+const SCORE_THRESHOLD = 50;
+// ---------------------------------------------------------------------------
+// Core routing
+// ---------------------------------------------------------------------------
+function scoreCandidate(requirements, candidate) {
+    const breakdown = {
+        capabilities: 0,
+        model: 0,
+        tools: 0,
+        permissions: 0,
+    };
+    // -- Capabilities (hard requirement: all must be present) --
+    const reqCaps = requirements.requiredCapabilities;
+    if (reqCaps.length === 0) {
+        breakdown.capabilities = WEIGHT_CAPABILITIES;
+    }
+    else {
+        const hasAll = reqCaps.every((c) => candidate.capabilities.includes(c));
+        if (!hasAll) {
+            return { name: candidate.name, total: 0, breakdown, disqualified: true };
+        }
+        breakdown.capabilities = WEIGHT_CAPABILITIES;
+    }
+    // -- Model (exact > partial family > no match) --
+    if (!requirements.preferredModel) {
+        breakdown.model = WEIGHT_MODEL;
+    }
+    else {
+        const preferred = requirements.preferredModel.toLowerCase();
+        const hasExact = candidate.supportedModels.some((m) => m.toLowerCase() === preferred);
+        if (hasExact) {
+            breakdown.model = WEIGHT_MODEL;
+        }
+        else {
+            // Partial: same family prefix (e.g., "claude-opus" matches "claude-opus-4-0")
+            const family = preferred.split("-").slice(0, 2).join("-");
+            const hasFamily = candidate.supportedModels.some((m) => m.toLowerCase().startsWith(family));
+            breakdown.model = hasFamily ? Math.round(WEIGHT_MODEL * 0.6) : 0;
+        }
+    }
+    // -- Tools (ratio of matched) --
+    const reqTools = requirements.requiredTools;
+    if (reqTools.length === 0) {
+        breakdown.tools = WEIGHT_TOOLS;
+    }
+    else {
+        const matched = reqTools.filter((t) => candidate.availableTools.some((at) => at.toLowerCase() === t.toLowerCase())).length;
+        breakdown.tools = Math.round((matched / reqTools.length) * WEIGHT_TOOLS);
+    }
+    // -- Permissions (ratio of matched) --
+    const reqPerms = requirements.requiredPermissions;
+    if (reqPerms.length === 0) {
+        breakdown.permissions = WEIGHT_PERMISSIONS;
+    }
+    else {
+        const matched = reqPerms.filter((p) => candidate.permissions.some((cp) => cp.toLowerCase() === p.toLowerCase())).length;
+        breakdown.permissions = Math.round((matched / reqPerms.length) * WEIGHT_PERMISSIONS);
+    }
+    const total = breakdown.capabilities +
+        breakdown.model +
+        breakdown.tools +
+        breakdown.permissions;
+    return { name: candidate.name, total, breakdown, disqualified: false };
+}
+/**
+ * Select the best harness candidate for a set of task requirements.
+ * Returns null if no candidate meets the threshold (50).
+ */
+function selectHarness(requirements, candidates) {
+    if (candidates.length === 0)
+        return null;
+    const fullReqs = {
+        requiredCapabilities: requirements.requiredCapabilities ?? [],
+        preferredModel: requirements.preferredModel,
+        requiredTools: requirements.requiredTools ?? [],
+        requiredPermissions: requirements.requiredPermissions ?? [],
+        preferredHarness: requirements.preferredHarness,
+    };
+    const scores = candidates.map((c) => scoreCandidate(fullReqs, c));
+    // Filter out disqualified candidates
+    const eligible = scores.filter((s) => !s.disqualified);
+    if (eligible.length === 0)
+        return null;
+    // Sort by total score descending; preferred harness breaks ties
+    eligible.sort((a, b) => {
+        if (b.total !== a.total)
+            return b.total - a.total;
+        // Tiebreaker: prefer the harness named in preferredHarness
+        if (fullReqs.preferredHarness) {
+            if (a.name === fullReqs.preferredHarness)
+                return -1;
+            if (b.name === fullReqs.preferredHarness)
+                return 1;
+        }
+        return 0;
+    });
+    const best = eligible[0];
+    if (best.total < SCORE_THRESHOLD)
+        return null;
+    const selected = candidates.find((c) => c.name === best.name);
+    return {
+        selected,
+        score: best.total,
+        scoreBreakdown: best.breakdown,
+        scores,
+        candidates,
+    };
+}
+// ---------------------------------------------------------------------------
+// Discovery enrichment
+// ---------------------------------------------------------------------------
+/** Known capability mappings for harnesses not captured in discovery. */
+const KNOWN_CAPABILITY_MAP = {};
+// Build map from KNOWN_HARNESSES
+for (const spec of babysitter_sdk_1.KNOWN_HARNESSES) {
+    // All known harnesses support Programmatic invocation
+    const caps = [...spec.capabilities];
+    if (!caps.includes(types_1.HarnessCapability.Programmatic)) {
+        caps.unshift(types_1.HarnessCapability.Programmatic);
+    }
+    KNOWN_CAPABILITY_MAP[spec.name] = caps;
+}
+/**
+ * Enrich discovery results with capabilities from the known harness registry.
+ * Merges discovered capabilities with known capabilities, deduplicating.
+ */
+function enrichDiscoveryWithCapabilities(discoveries) {
+    return discoveries.map((d) => {
+        const known = KNOWN_CAPABILITY_MAP[d.name];
+        if (!known)
+            return d;
+        const merged = [...new Set([...d.capabilities, ...known])];
+        return { ...d, capabilities: merged };
+    });
+}
+/**
+ * Build TaskRequirements from a TaskDef's execution hints and kind.
+ */
+function buildTaskRequirements(taskDef) {
+    const exec = taskDef.execution ?? {};
+    const requiredCapabilities = [];
+    // Map task kind to required capabilities
+    if (taskDef.kind === "breakpoint") {
+        requiredCapabilities.push(types_1.HarnessCapability.HeadlessPrompt);
+    }
+    if (taskDef.kind === "orchestrator_task") {
+        requiredCapabilities.push(types_1.HarnessCapability.Programmatic);
+    }
+    return {
+        requiredCapabilities,
+        preferredModel: exec.model,
+        requiredTools: [],
+        requiredPermissions: (exec.permissions) ?? [],
+        preferredHarness: exec.harness,
+    };
+}

package/dist/harness/extensionToolBridge.d.ts

@@ -0,0 +1,13 @@
+import type { ExtensionRegistry } from '@a5c-ai/genty-core/extensions';
+export interface BridgedToolDefinition {
+    name: string;
+    description: string;
+    execute: (params: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+export declare function bridgeExtensionTools(registry: ExtensionRegistry): BridgedToolDefinition[];
+//# sourceMappingURL=extensionToolBridge.d.ts.map

package/dist/harness/extensionToolBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionToolBridge.d.ts","sourceRoot":"","sources":["../../src/harness/extensionToolBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC3G;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,qBAAqB,EAAE,CAkBzF"}

package/dist/harness/extensionToolBridge.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bridgeExtensionTools = bridgeExtensionTools;
+function bridgeExtensionTools(registry) {
+    return registry.getAllTools().map((extTool) => ({
+        name: extTool.name,
+        description: extTool.description,
+        execute: async (params) => {
+            try {
+                const result = await extTool.handler(params);
+                return {
+                    content: [{ type: 'text', text: typeof result === 'string' ? result : JSON.stringify(result) }],
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: 'text', text: `Extension tool error: ${message}` }],
+                };
+            }
+        },
+    }));
+}

package/dist/harness/fallbackChains.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GAP-HADAPT-004: Harness Fallback Chains.
+ *
+ * Defines ordered fallback sequences for harness resolution.
+ * When a primary harness fails or is unavailable, the chain
+ * determines the next harness to try.
+ */
+export interface FallbackChain {
+    /** Ordered list of harness names (primary first). */
+    harnesses: string[];
+    /** Maximum number of retries (fallback attempts). */
+    maxRetries: number;
+}
+export interface FallbackChainOptions {
+    /** Maximum retries. Clamped to chain.length - 1. */
+    maxRetries?: number;
+}
+export interface FallbackResolution {
+    /** The harness to use, or null if all exhausted. */
+    harness: string | null;
+    /** 1-based attempt number. */
+    attempt: number;
+    /** Whether this is a fallback (not the primary). */
+    isFallback: boolean;
+    /** Whether all harnesses in the chain have been exhausted. */
+    exhausted: boolean;
+}
+/**
+ * Create a fallback chain from an ordered list of harness names.
+ *
+ * Duplicates are removed (first occurrence wins).
+ * maxRetries defaults to chain.length - 1 (try every harness once).
+ */
+export declare function createFallbackChain(harnesses: string[], options?: FallbackChainOptions): FallbackChain;
+/**
+ * Resolve which harness to use given a chain and previously failed harnesses.
+ *
+ * Returns the first harness in the chain that hasn't failed yet,
+ * respecting the maxRetries limit.
+ */
+export declare function resolveFallbackHarness(chain: FallbackChain, failedHarnesses: string[]): FallbackResolution;
+//# sourceMappingURL=fallbackChains.d.ts.map

package/dist/harness/fallbackChains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackChains.d.ts","sourceRoot":"","sources":["../../src/harness/fallbackChains.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAYf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,eAAe,EAAE,MAAM,EAAE,GACxB,kBAAkB,CAiCpB"}

package/dist/harness/fallbackChains.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * GAP-HADAPT-004: Harness Fallback Chains.
+ *
+ * Defines ordered fallback sequences for harness resolution.
+ * When a primary harness fails or is unavailable, the chain
+ * determines the next harness to try.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFallbackChain = createFallbackChain;
+exports.resolveFallbackHarness = resolveFallbackHarness;
+// ---------------------------------------------------------------------------
+// Core
+// ---------------------------------------------------------------------------
+/**
+ * Create a fallback chain from an ordered list of harness names.
+ *
+ * Duplicates are removed (first occurrence wins).
+ * maxRetries defaults to chain.length - 1 (try every harness once).
+ */
+function createFallbackChain(harnesses, options) {
+    // Deduplicate preserving order
+    const unique = [...new Set(harnesses)];
+    const maxPossible = Math.max(0, unique.length - 1);
+    const maxRetries = options?.maxRetries !== undefined
+        ? Math.min(options.maxRetries, maxPossible)
+        : maxPossible;
+    return {
+        harnesses: unique,
+        maxRetries,
+    };
+}
+/**
+ * Resolve which harness to use given a chain and previously failed harnesses.
+ *
+ * Returns the first harness in the chain that hasn't failed yet,
+ * respecting the maxRetries limit.
+ */
+function resolveFallbackHarness(chain, failedHarnesses) {
+    const failedSet = new Set(failedHarnesses);
+    const attempt = failedHarnesses.length + 1;
+    // Check retry limit: attempts beyond maxRetries + 1 are exhausted
+    if (failedHarnesses.length > chain.maxRetries) {
+        return {
+            harness: null,
+            attempt,
+            isFallback: attempt > 1,
+            exhausted: true,
+        };
+    }
+    // Find the first non-failed harness in chain order
+    for (const harness of chain.harnesses) {
+        if (!failedSet.has(harness)) {
+            return {
+                harness,
+                attempt,
+                isFallback: harness !== chain.harnesses[0],
+                exhausted: false,
+            };
+        }
+    }
+    // All harnesses in the chain have failed
+    return {
+        harness: null,
+        attempt,
+        isFallback: true,
+        exhausted: true,
+    };
+}

package/dist/harness/gentySessionContext.d.ts

@@ -0,0 +1,31 @@
+import { ExtensionRegistry } from '@a5c-ai/genty-core/extensions';
+import type { IdentityKeyPair } from '@a5c-ai/genty-core/trust';
+import { type DynamicContextPipeline } from '../context/dynamic.js';
+import { type LoadedInstructions } from '../context/instructions.js';
+import { SteeringQueue } from '../interaction/steering.js';
+import { type ModelSwitchState } from '../interaction/model-switch.js';
+export interface GentySessionContextOptions {
+    workspace: string;
+    model?: string;
+    provider?: string;
+    agentId?: string;
+    sessionId: string;
+    isolated?: boolean;
+}
+export interface GentySessionContext {
+    readonly agentId: string;
+    readonly sessionId: string;
+    readonly keyPair: IdentityKeyPair;
+    readonly extensionRegistry: ExtensionRegistry;
+    readonly dynamicContext: DynamicContextPipeline;
+    readonly instructions: LoadedInstructions;
+    readonly steeringQueue: SteeringQueue;
+    readonly modelSwitch: ModelSwitchState;
+    readonly extensionLoadResult: {
+        activated: string[];
+        failed: string[];
+    };
+}
+export declare function createGentySessionContext(opts: GentySessionContextOptions): Promise<GentySessionContext>;
+export declare function destroyGentySessionContext(ctx: GentySessionContext): Promise<void>;
+//# sourceMappingURL=gentySessionContext.d.ts.map

package/dist/harness/gentySessionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gentySessionContext.d.ts","sourceRoot":"","sources":["../../src/harness/gentySessionContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAG/F,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACzE;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CA8C9B;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF"}

package/dist/harness/gentySessionContext.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGentySessionContext = createGentySessionContext;
+exports.destroyGentySessionContext = destroyGentySessionContext;
+const extensions_1 = require("@a5c-ai/genty-core/extensions");
+const key_store_js_1 = require("../trust/key-store.js");
+const dynamic_js_1 = require("../context/dynamic.js");
+const instructions_js_1 = require("../context/instructions.js");
+const steering_js_1 = require("../interaction/steering.js");
+const model_switch_js_1 = require("../interaction/model-switch.js");
+const discovery_js_1 = require("../extensions/discovery.js");
+async function createGentySessionContext(opts) {
+    const agentId = opts.agentId ?? `genty-${opts.sessionId}`;
+    // 1. Key persistence — load or create agent key
+    const storedKey = (0, key_store_js_1.loadOrCreate)(agentId, `session:${opts.sessionId}`);
+    // 2. Extension registry
+    const extensionRegistry = new extensions_1.ExtensionRegistry();
+    // 3. Dynamic context pipeline
+    const dynamicContext = (0, dynamic_js_1.createDynamicContextPipeline)();
+    // 4. Instructions loader (AGENTS.md / SYSTEM.md)
+    const instructions = (0, instructions_js_1.loadInstructions)(opts.workspace);
+    // 5. Steering queue
+    const steeringQueue = new steering_js_1.SteeringQueue();
+    // 6. Model switch state
+    const modelSwitch = (0, model_switch_js_1.createModelSwitchState)(opts.model ?? 'claude-sonnet-4-6', opts.provider ?? 'anthropic');
+    // 7. Discover and activate extensions (unless isolated)
+    let extensionLoadResult = { activated: [], failed: [] };
+    if (!opts.isolated) {
+        extensionLoadResult = await (0, discovery_js_1.activateDiscoveredExtensions)(extensionRegistry);
+        // Wire extension context providers into the dynamic context pipeline
+        for (const provider of extensionRegistry.getContextProviders()) {
+            dynamicContext.addProvider(provider);
+        }
+    }
+    return {
+        agentId,
+        sessionId: opts.sessionId,
+        keyPair: storedKey.keyPair,
+        extensionRegistry,
+        dynamicContext,
+        instructions,
+        steeringQueue,
+        modelSwitch,
+        extensionLoadResult,
+    };
+}
+async function destroyGentySessionContext(ctx) {
+    await ctx.extensionRegistry.deactivateAll();
+}

package/dist/harness/gentySessionIntegration.d.ts

@@ -0,0 +1,16 @@
+import type { GentySessionContext } from './gentySessionContext.js';
+import type { AgentCoreSessionOptions } from './types.js';
+import type { TrustContext } from '../trust/harness-signing.js';
+export declare function applyInstructionsToSessionOptions(ctx: GentySessionContext, opts: AgentCoreSessionOptions): AgentCoreSessionOptions;
+export declare function applyExtensionToolsToSessionOptions(ctx: GentySessionContext, opts: AgentCoreSessionOptions): AgentCoreSessionOptions;
+export declare function applyDynamicContextToMessages(ctx: GentySessionContext, messages: Array<{
+    role: string;
+    content: string;
+}>, turnNumber: number): Promise<Array<{
+    role: string;
+    content: string;
+}>>;
+export declare function drainSteeringMessages(ctx: GentySessionContext): string | undefined;
+export declare function getTrustContext(ctx: GentySessionContext): TrustContext;
+export declare function getCurrentModel(ctx: GentySessionContext): string;
+//# sourceMappingURL=gentySessionIntegration.d.ts.map

package/dist/harness/gentySessionIntegration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gentySessionIntegration.d.ts","sourceRoot":"","sources":["../../src/harness/gentySessionIntegration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,uBAAuB,GAC5B,uBAAuB,CAsBzB;AAED,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,uBAAuB,GAC5B,uBAAuB,CAQzB;AAED,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CASnD;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,mBAAmB,GACvB,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,YAAY,CAMtE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAEhE"}