@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

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

@@ -0,0 +1,63 @@
+/**
+ * Host Contract Layer (GAP-REMOTE-007).
+ *
+ * Defines the formal contract between babysitter and host environments.
+ * Pure functions for resolving, validating, and building host manifests.
+ */
+import type { HarnessAdapter, HarnessDiscoveryResult, HarnessCapability } from "./types";
+export type CommunicationProtocol = "stdio" | "websocket" | "http" | "mcp";
+export interface HostLifecycleSupport {
+    supportsSessionBinding: boolean;
+    supportsStopHook: boolean;
+    supportsGracefulShutdown: boolean;
+    supportsHealthCheck: boolean;
+}
+export interface HostLimits {
+    maxConcurrentSessions?: number;
+    maxPromptTokens?: number;
+    timeoutMs?: number;
+}
+export interface HostCapabilityManifest {
+    harnessName: string;
+    version?: string;
+    capabilities: HarnessCapability[];
+    supportedModels: string[];
+    communication: {
+        protocol: CommunicationProtocol;
+        supportsStreaming: boolean;
+        supportsJsonMode: boolean;
+    };
+    lifecycle: HostLifecycleSupport;
+    limits: HostLimits;
+}
+export interface HostContractViolation {
+    field: string;
+    requirement: string;
+    actual: string;
+    severity: "error" | "warning";
+}
+export interface HostContractValidationResult {
+    valid: boolean;
+    violations: HostContractViolation[];
+    capabilities: HarnessCapability[];
+}
+/** Optional requirements to validate a manifest against. */
+export interface ManifestRequirements {
+    requiredCapabilities?: HarnessCapability[];
+    minTimeoutMs?: number;
+}
+/**
+ * Resolve a HarnessAdapter into a HostCapabilityManifest.
+ * Uses the adapter's getCapabilities() if available, otherwise defaults.
+ */
+export declare function resolveHostCapabilities(adapter: HarnessAdapter): HostCapabilityManifest;
+/**
+ * Validate a HostCapabilityManifest for structural correctness and
+ * optional conformance to task requirements.
+ */
+export declare function validateHostContract(manifest: HostCapabilityManifest, requirements?: ManifestRequirements): HostContractValidationResult;
+/**
+ * Construct a HostCapabilityManifest from a HarnessDiscoveryResult.
+ */
+export declare function buildManifestFromDiscovery(discovery: HarnessDiscoveryResult): HostCapabilityManifest;
+//# sourceMappingURL=hostContract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostContract.d.ts","sourceRoot":"","sources":["../../src/harness/hostContract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAOzF,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,sBAAsB,EAAE,OAAO,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE;QACb,QAAQ,EAAE,qBAAqB,CAAC;QAChC,iBAAiB,EAAE,OAAO,CAAC;QAC3B,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,GACtB,sBAAsB,CAuBxB;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,EAChC,YAAY,CAAC,EAAE,oBAAoB,GAClC,4BAA4B,CAuE9B;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,sBAAsB,GAChC,sBAAsB,CAsBxB"}

package/dist/harness/hostContract.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Host Contract Layer (GAP-REMOTE-007).
+ *
+ * Defines the formal contract between babysitter and host environments.
+ * Pure functions for resolving, validating, and building host manifests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveHostCapabilities = resolveHostCapabilities;
+exports.validateHostContract = validateHostContract;
+exports.buildManifestFromDiscovery = buildManifestFromDiscovery;
+const types_1 = require("./types");
+// ---------------------------------------------------------------------------
+// Resolve: adapter → manifest
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a HarnessAdapter into a HostCapabilityManifest.
+ * Uses the adapter's getCapabilities() if available, otherwise defaults.
+ */
+function resolveHostCapabilities(adapter) {
+    const caps = adapter.getCapabilities?.() ?? [];
+    const hasCapability = (cap) => caps.includes(cap);
+    return {
+        harnessName: adapter.name,
+        version: undefined,
+        capabilities: caps,
+        supportedModels: [],
+        communication: {
+            protocol: "stdio",
+            supportsStreaming: hasCapability(types_1.HarnessCapability.Programmatic),
+            supportsJsonMode: hasCapability(types_1.HarnessCapability.Programmatic),
+        },
+        lifecycle: {
+            supportsSessionBinding: hasCapability(types_1.HarnessCapability.SessionBinding),
+            supportsStopHook: hasCapability(types_1.HarnessCapability.StopHook),
+            supportsGracefulShutdown: hasCapability(types_1.HarnessCapability.StopHook),
+            supportsHealthCheck: false,
+        },
+        limits: {},
+    };
+}
+// ---------------------------------------------------------------------------
+// Validate: manifest → validation result
+// ---------------------------------------------------------------------------
+/**
+ * Validate a HostCapabilityManifest for structural correctness and
+ * optional conformance to task requirements.
+ */
+function validateHostContract(manifest, requirements) {
+    const violations = [];
+    // Required fields
+    if (!manifest.harnessName) {
+        violations.push({
+            field: "harnessName",
+            requirement: "harnessName must be a non-empty string",
+            actual: String(manifest.harnessName ?? "undefined"),
+            severity: "error",
+        });
+    }
+    // Capability-lifecycle consistency
+    const hasCap = (cap) => manifest.capabilities.includes(cap);
+    if (hasCap(types_1.HarnessCapability.SessionBinding) && !manifest.lifecycle.supportsSessionBinding) {
+        violations.push({
+            field: "lifecycle.supportsSessionBinding",
+            requirement: "SessionBinding capability declared but lifecycle.supportsSessionBinding is false",
+            actual: "false",
+            severity: "error",
+        });
+    }
+    if (hasCap(types_1.HarnessCapability.StopHook) && !manifest.lifecycle.supportsStopHook) {
+        violations.push({
+            field: "lifecycle.supportsStopHook",
+            requirement: "StopHook capability declared but lifecycle.supportsStopHook is false",
+            actual: "false",
+            severity: "error",
+        });
+    }
+    // Task requirements validation
+    if (requirements) {
+        if (requirements.requiredCapabilities) {
+            for (const cap of requirements.requiredCapabilities) {
+                if (!hasCap(cap)) {
+                    violations.push({
+                        field: "capabilities",
+                        requirement: `Required capability: ${cap}`,
+                        actual: `Missing: ${cap}`,
+                        severity: "error",
+                    });
+                }
+            }
+        }
+        if (requirements.minTimeoutMs != null &&
+            manifest.limits.timeoutMs != null &&
+            manifest.limits.timeoutMs < requirements.minTimeoutMs) {
+            violations.push({
+                field: "limits.timeoutMs",
+                requirement: `Minimum timeout: ${requirements.minTimeoutMs}ms`,
+                actual: `${manifest.limits.timeoutMs}ms`,
+                severity: "error",
+            });
+        }
+    }
+    return {
+        valid: violations.filter((v) => v.severity === "error").length === 0,
+        violations,
+        capabilities: manifest.capabilities,
+    };
+}
+// ---------------------------------------------------------------------------
+// Build: discovery result → manifest
+// ---------------------------------------------------------------------------
+/**
+ * Construct a HostCapabilityManifest from a HarnessDiscoveryResult.
+ */
+function buildManifestFromDiscovery(discovery) {
+    const caps = discovery.capabilities ?? [];
+    const hasCap = (cap) => caps.includes(cap);
+    return {
+        harnessName: discovery.name,
+        version: discovery.version,
+        capabilities: caps,
+        supportedModels: [],
+        communication: {
+            protocol: "stdio",
+            supportsStreaming: hasCap(types_1.HarnessCapability.Programmatic) || discovery.installed,
+            supportsJsonMode: hasCap(types_1.HarnessCapability.Programmatic) || discovery.installed,
+        },
+        lifecycle: {
+            supportsSessionBinding: hasCap(types_1.HarnessCapability.SessionBinding),
+            supportsStopHook: hasCap(types_1.HarnessCapability.StopHook),
+            supportsGracefulShutdown: hasCap(types_1.HarnessCapability.StopHook),
+            supportsHealthCheck: false,
+        },
+        limits: {},
+    };
+}

package/dist/harness/index.d.ts

@@ -0,0 +1,10 @@
+export type { HarnessAdapter, SessionBindOptions, SessionBindResult, HookHandlerArgs, HarnessDiscoveryResult, CallerHarnessResult, HarnessInvokeOptions, HarnessInvokeResult, HarnessInstallOptions, HarnessInstallResult, AgentCoreSessionOptions, AgentCorePromptResult, AgentCoreSessionEvent, StreamingOutputCallback, StreamingLineCallback, StreamingOutputOptions, } from "./types";
+export { HarnessCapability } from "./types";
+export { discoverHarnesses, detectCallerHarness, checkCliAvailable, KNOWN_HARNESSES, detectAdapter, getAdapterByName, listSupportedHarnesses, getAdapter, setAdapter, resetAdapter, } from "@a5c-ai/babysitter-sdk";
+export { createAgentCoreToolDefinitions, disposeAgentCoreToolDefinitions, type AgenticToolOptions, type CustomToolDefinition, AGENTIC_TOOL_NAMES, stripHtmlTags, extractTextFromHtml, filterByRelevance, parseSearchResults, } from "@a5c-ai/agent-core";
+export { invokeHarness, buildHarnessArgs, HARNESS_CLI_MAP } from "./invoker";
+export { buildLaunchSpec } from "./invoker/launch";
+export { createAgentCoreSession, type AgentCoreEventListener } from "@a5c-ai/agent-core";
+export type { AgentCoreSessionHandle } from "@a5c-ai/agent-core";
+export * as amux from "./amux";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACzF,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC"}

package/dist/harness/index.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.amux = exports.createAgentCoreSession = exports.buildLaunchSpec = exports.HARNESS_CLI_MAP = exports.buildHarnessArgs = exports.invokeHarness = exports.parseSearchResults = exports.filterByRelevance = exports.extractTextFromHtml = exports.stripHtmlTags = exports.AGENTIC_TOOL_NAMES = exports.disposeAgentCoreToolDefinitions = exports.createAgentCoreToolDefinitions = exports.resetAdapter = exports.setAdapter = exports.getAdapter = exports.listSupportedHarnesses = exports.getAdapterByName = exports.detectAdapter = exports.KNOWN_HARNESSES = exports.checkCliAvailable = exports.detectCallerHarness = exports.discoverHarnesses = exports.HarnessCapability = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "HarnessCapability", { enumerable: true, get: function () { return types_1.HarnessCapability; } });
+var babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+Object.defineProperty(exports, "discoverHarnesses", { enumerable: true, get: function () { return babysitter_sdk_1.discoverHarnesses; } });
+Object.defineProperty(exports, "detectCallerHarness", { enumerable: true, get: function () { return babysitter_sdk_1.detectCallerHarness; } });
+Object.defineProperty(exports, "checkCliAvailable", { enumerable: true, get: function () { return babysitter_sdk_1.checkCliAvailable; } });
+Object.defineProperty(exports, "KNOWN_HARNESSES", { enumerable: true, get: function () { return babysitter_sdk_1.KNOWN_HARNESSES; } });
+Object.defineProperty(exports, "detectAdapter", { enumerable: true, get: function () { return babysitter_sdk_1.detectAdapter; } });
+Object.defineProperty(exports, "getAdapterByName", { enumerable: true, get: function () { return babysitter_sdk_1.getAdapterByName; } });
+Object.defineProperty(exports, "listSupportedHarnesses", { enumerable: true, get: function () { return babysitter_sdk_1.listSupportedHarnesses; } });
+Object.defineProperty(exports, "getAdapter", { enumerable: true, get: function () { return babysitter_sdk_1.getAdapter; } });
+Object.defineProperty(exports, "setAdapter", { enumerable: true, get: function () { return babysitter_sdk_1.setAdapter; } });
+Object.defineProperty(exports, "resetAdapter", { enumerable: true, get: function () { return babysitter_sdk_1.resetAdapter; } });
+var agent_core_1 = require("@a5c-ai/agent-core");
+Object.defineProperty(exports, "createAgentCoreToolDefinitions", { enumerable: true, get: function () { return agent_core_1.createAgentCoreToolDefinitions; } });
+Object.defineProperty(exports, "disposeAgentCoreToolDefinitions", { enumerable: true, get: function () { return agent_core_1.disposeAgentCoreToolDefinitions; } });
+Object.defineProperty(exports, "AGENTIC_TOOL_NAMES", { enumerable: true, get: function () { return agent_core_1.AGENTIC_TOOL_NAMES; } });
+Object.defineProperty(exports, "stripHtmlTags", { enumerable: true, get: function () { return agent_core_1.stripHtmlTags; } });
+Object.defineProperty(exports, "extractTextFromHtml", { enumerable: true, get: function () { return agent_core_1.extractTextFromHtml; } });
+Object.defineProperty(exports, "filterByRelevance", { enumerable: true, get: function () { return agent_core_1.filterByRelevance; } });
+Object.defineProperty(exports, "parseSearchResults", { enumerable: true, get: function () { return agent_core_1.parseSearchResults; } });
+var invoker_1 = require("./invoker");
+Object.defineProperty(exports, "invokeHarness", { enumerable: true, get: function () { return invoker_1.invokeHarness; } });
+Object.defineProperty(exports, "buildHarnessArgs", { enumerable: true, get: function () { return invoker_1.buildHarnessArgs; } });
+Object.defineProperty(exports, "HARNESS_CLI_MAP", { enumerable: true, get: function () { return invoker_1.HARNESS_CLI_MAP; } });
+var launch_1 = require("./invoker/launch");
+Object.defineProperty(exports, "buildLaunchSpec", { enumerable: true, get: function () { return launch_1.buildLaunchSpec; } });
+var agent_core_2 = require("@a5c-ai/agent-core");
+Object.defineProperty(exports, "createAgentCoreSession", { enumerable: true, get: function () { return agent_core_2.createAgentCoreSession; } });
+exports.amux = __importStar(require("./amux"));