@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/harness/adapters/adapterTypes.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * adapters type adapters for agent-platform.
+ *
+ * Keeps a structural compatibility layer for the subset of adapters surface
+ * that agent-platform consumes, without requiring TypeScript to resolve the
+ * full @a5c-ai/adapters package during agent-platform compilation.
+ *
+ * @module harness/adapters/adapterTypes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,17 @@
+/**
+ * adapters integration bridge for agent-platform.
+ *
+ * This module provides an alternative invocation path that delegates to
+ * an AgentMuxClient rather than spawning harness CLIs directly. The existing
+ * invoker.ts is preserved as a fallback.
+ *
+ * @module harness/adapters
+ */
+export type { AgentMuxRunOptions, AgentMuxRunHandle, AdapterAgentEvent, AdapterInteractionChannel, AgentMuxClient, AdapterAdapterInfo, AdapterAdapterInstallationCheck, AdapterAuthCheck, AgentMuxClientWithDiscovery, } from "./adapterTypes";
+export { HARNESS_TO_AGENT_MUX_ADAPTER, mapHarnessToAmuxAdapter, hasAmuxAdapter, } from "./adapterHarnessMap";
+export { mapAmuxEvent, isToolEvent, isCostEvent, isInteractiveEvent, isErrorEvent, isSessionLifecycleEvent, type BabysitterEvent, type BabysitterEventKind, } from "./adapterEventMapper";
+export { invokeViaAgentMux, type AdapterBridgeOptions, type AgentMuxBridgeResult, type AdapterEventCallback, } from "./adapterBridge";
+export { getAgentMuxClient, isAgentMuxAvailable, _resetAgentMuxClientCache, } from "./adapterClientFactory";
+export { AdapterEventEmitter } from "./adapterEventEmitter";
+export { createAmuxStdinReader, waitForInteractionResponse, type AdapterInteractionEvent, } from "./adapterStdinReader";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/harness/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,cAAc,EACd,kBAAkB,EAClB,+BAA+B,EAC/B,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC"}

package/dist/harness/adapters/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * adapters integration bridge for agent-platform.
+ *
+ * This module provides an alternative invocation path that delegates to
+ * an AgentMuxClient rather than spawning harness CLIs directly. The existing
+ * invoker.ts is preserved as a fallback.
+ *
+ * @module harness/adapters
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForInteractionResponse = exports.createAmuxStdinReader = exports.AdapterEventEmitter = exports._resetAgentMuxClientCache = exports.isAgentMuxAvailable = exports.getAgentMuxClient = exports.invokeViaAgentMux = exports.isSessionLifecycleEvent = exports.isErrorEvent = exports.isInteractiveEvent = exports.isCostEvent = exports.isToolEvent = exports.mapAmuxEvent = exports.hasAmuxAdapter = exports.mapHarnessToAmuxAdapter = exports.HARNESS_TO_AGENT_MUX_ADAPTER = void 0;
+var adapterHarnessMap_1 = require("./adapterHarnessMap");
+Object.defineProperty(exports, "HARNESS_TO_AGENT_MUX_ADAPTER", { enumerable: true, get: function () { return adapterHarnessMap_1.HARNESS_TO_AGENT_MUX_ADAPTER; } });
+Object.defineProperty(exports, "mapHarnessToAmuxAdapter", { enumerable: true, get: function () { return adapterHarnessMap_1.mapHarnessToAmuxAdapter; } });
+Object.defineProperty(exports, "hasAmuxAdapter", { enumerable: true, get: function () { return adapterHarnessMap_1.hasAmuxAdapter; } });
+var adapterEventMapper_1 = require("./adapterEventMapper");
+Object.defineProperty(exports, "mapAmuxEvent", { enumerable: true, get: function () { return adapterEventMapper_1.mapAmuxEvent; } });
+Object.defineProperty(exports, "isToolEvent", { enumerable: true, get: function () { return adapterEventMapper_1.isToolEvent; } });
+Object.defineProperty(exports, "isCostEvent", { enumerable: true, get: function () { return adapterEventMapper_1.isCostEvent; } });
+Object.defineProperty(exports, "isInteractiveEvent", { enumerable: true, get: function () { return adapterEventMapper_1.isInteractiveEvent; } });
+Object.defineProperty(exports, "isErrorEvent", { enumerable: true, get: function () { return adapterEventMapper_1.isErrorEvent; } });
+Object.defineProperty(exports, "isSessionLifecycleEvent", { enumerable: true, get: function () { return adapterEventMapper_1.isSessionLifecycleEvent; } });
+var adapterBridge_1 = require("./adapterBridge");
+Object.defineProperty(exports, "invokeViaAgentMux", { enumerable: true, get: function () { return adapterBridge_1.invokeViaAgentMux; } });
+var adapterClientFactory_1 = require("./adapterClientFactory");
+Object.defineProperty(exports, "getAgentMuxClient", { enumerable: true, get: function () { return adapterClientFactory_1.getAgentMuxClient; } });
+Object.defineProperty(exports, "isAgentMuxAvailable", { enumerable: true, get: function () { return adapterClientFactory_1.isAgentMuxAvailable; } });
+Object.defineProperty(exports, "_resetAgentMuxClientCache", { enumerable: true, get: function () { return adapterClientFactory_1._resetAgentMuxClientCache; } });
+var adapterEventEmitter_1 = require("./adapterEventEmitter");
+Object.defineProperty(exports, "AdapterEventEmitter", { enumerable: true, get: function () { return adapterEventEmitter_1.AdapterEventEmitter; } });
+var adapterStdinReader_1 = require("./adapterStdinReader");
+Object.defineProperty(exports, "createAmuxStdinReader", { enumerable: true, get: function () { return adapterStdinReader_1.createAmuxStdinReader; } });
+Object.defineProperty(exports, "waitForInteractionResponse", { enumerable: true, get: function () { return adapterStdinReader_1.waitForInteractionResponse; } });

package/dist/harness/backgroundTracker.d.ts

@@ -0,0 +1,64 @@
+export interface BackgroundEffectEntry {
+    effectId: string;
+    invocationKey: string;
+    kind: string;
+    dispatchedAt: string;
+    pollIntervalMs: number;
+    timeoutMs?: number;
+}
+export interface BackgroundEffectStatus {
+    effectId: string;
+    state: "running" | "completed" | "error" | "timed_out";
+    lastPolledAt: string;
+}
+interface CompletedEntry {
+    effectId: string;
+    result?: {
+        status: string;
+        value?: unknown;
+        error?: unknown;
+    };
+}
+/**
+ * Tracks background effects that have been dispatched but not yet resolved.
+ * Supports polling, timeout checking, and collecting completed results.
+ */
+export declare class BackgroundEffectTracker {
+    private readonly effects;
+    /**
+     * Start tracking a dispatched background effect.
+     */
+    track(entry: BackgroundEffectEntry): void;
+    /**
+     * Get all currently tracked (non-completed) effects.
+     */
+    getAll(): BackgroundEffectEntry[];
+    /**
+     * Get a tracked effect by effectId, or undefined if not found.
+     */
+    get(effectId: string): BackgroundEffectEntry | undefined;
+    /**
+     * Poll a background effect's status. Updates lastPolledAt.
+     * Throws if the effectId is not tracked.
+     */
+    poll(effectId: string): BackgroundEffectStatus;
+    /**
+     * Mark a background effect as completed with a result.
+     */
+    markCompleted(effectId: string, result: {
+        status: string;
+        value?: unknown;
+        error?: unknown;
+    }): void;
+    /**
+     * Collect and remove all completed effects from the tracker.
+     */
+    collectCompleted(): CompletedEntry[];
+    /**
+     * Check all tracked effects for timeout. Effects that have exceeded their
+     * timeoutMs are marked as completed with an error.
+     */
+    checkTimeouts(): void;
+}
+export {};
+//# sourceMappingURL=backgroundTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundTracker.d.ts","sourceRoot":"","sources":["../../src/harness/backgroundTracker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;IACvD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAaD;;;GAGG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAOzC;;OAEG;IACH,MAAM,IAAI,qBAAqB,EAAE;IAUjC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAMxD;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB;IAgB9C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IASnG;;OAEG;IACH,gBAAgB,IAAI,cAAc,EAAE;IAgBpC;;;OAGG;IACH,aAAa,IAAI,IAAI;CAmBtB"}

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/budgetDowngrade.d.ts

@@ -0,0 +1,12 @@
+export interface BudgetDowngradeResult {
+    currentModel: string;
+    suggestedModel: string;
+    reason: string;
+    currentCostPerMToken: number;
+    suggestedCostPerMToken: number;
+    savingsPercent: number;
+}
+export declare function suggestBudgetDowngrade(currentModel: string, currentCostUsd: number, budgetUsd: number, budgetThreshold?: number): BudgetDowngradeResult | undefined;
+export declare function getModelTier(model: string): number;
+export declare function isDowngradeAcceptable(currentModel: string, suggestedModel: string, minTier?: number): boolean;
+//# sourceMappingURL=budgetDowngrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budgetDowngrade.d.ts","sourceRoot":"","sources":["../../src/harness/budgetDowngrade.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AA+BD,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,eAAe,SAAM,GACpB,qBAAqB,GAAG,SAAS,CA4BnC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAIT"}

package/dist/harness/budgetDowngrade.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestBudgetDowngrade = suggestBudgetDowngrade;
+exports.getModelTier = getModelTier;
+exports.isDowngradeAcceptable = isDowngradeAcceptable;
+const types_1 = require("../cost/types");
+const MODEL_TIERS = [
+    ['claude-opus-4-6', 'claude-opus-4-5'],
+    ['claude-sonnet-4-6', 'claude-sonnet-4-5', 'claude-sonnet-4-0'],
+    ['claude-haiku-4-5', 'claude-haiku-3-5'],
+];
+function effectiveCostPerMToken(pricing) {
+    return pricing.inputPer1M + pricing.outputPer1M;
+}
+function findCheaperModels(currentModel) {
+    const currentPricing = (0, types_1.resolvePricing)(currentModel);
+    if (!currentPricing)
+        return [];
+    const currentCost = effectiveCostPerMToken(currentPricing);
+    const cheaper = [];
+    for (const [model, pricing] of Object.entries(types_1.MODEL_PRICING)) {
+        const cost = effectiveCostPerMToken(pricing);
+        if (cost < currentCost) {
+            cheaper.push({ model, cost });
+        }
+    }
+    // Sort by cost descending — prefer the closest cheaper model (least capability loss)
+    cheaper.sort((a, b) => b.cost - a.cost);
+    return cheaper.map(c => c.model);
+}
+function suggestBudgetDowngrade(currentModel, currentCostUsd, budgetUsd, budgetThreshold = 0.8) {
+    if (budgetUsd <= 0)
+        return undefined;
+    if (currentCostUsd < budgetUsd * budgetThreshold)
+        return undefined;
+    const currentPricing = (0, types_1.resolvePricing)(currentModel);
+    if (!currentPricing)
+        return undefined;
+    const cheaper = findCheaperModels(currentModel);
+    if (cheaper.length === 0)
+        return undefined;
+    const suggestedModel = cheaper[0];
+    const suggestedPricing = (0, types_1.resolvePricing)(suggestedModel);
+    if (!suggestedPricing)
+        return undefined;
+    const currentCost = effectiveCostPerMToken(currentPricing);
+    const suggestedCost = effectiveCostPerMToken(suggestedPricing);
+    const savingsPercent = Math.round(((currentCost - suggestedCost) / currentCost) * 100);
+    const budgetPercent = Math.round((currentCostUsd / budgetUsd) * 100);
+    return {
+        currentModel,
+        suggestedModel,
+        reason: `Session cost at ${budgetPercent}% of budget ($${currentCostUsd.toFixed(2)}/$${budgetUsd.toFixed(2)}). Downgrading from ${currentModel} to ${suggestedModel} saves ~${savingsPercent}% per token.`,
+        currentCostPerMToken: currentCost,
+        suggestedCostPerMToken: suggestedCost,
+        savingsPercent,
+    };
+}
+function getModelTier(model) {
+    for (let i = 0; i < MODEL_TIERS.length; i++) {
+        if (MODEL_TIERS[i].some(m => model.startsWith(m)))
+            return i;
+    }
+    return -1;
+}
+function isDowngradeAcceptable(currentModel, suggestedModel, minTier) {
+    const suggestedTier = getModelTier(suggestedModel);
+    if (minTier !== undefined && suggestedTier > minTier)
+        return false;
+    return suggestedTier >= 0;
+}

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,
+    };
+}