@xemahq/contracts 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+<p align="center">
+<svg width="680" height="120" viewBox="0 0 680 120" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="@xemahq/kernel-contracts">
+  <rect width="680" height="120" rx="14" fill="#0B1020"/>
+  <g transform="translate(28,34)">
+    <path d="M26 0 L52 15 L52 45 L26 60 L0 45 L0 15 Z" fill="#3B82F6" opacity="0.18"/>
+    <path d="M26 12 L41 21 L41 39 L26 48 L11 39 L11 21 Z" fill="#3B82F6"/>
+  </g>
+  <text x="92" y="52" font-family="ui-monospace,SFMono-Regular,Menlo,monospace" font-size="22" fill="#F8FAFC" font-weight="700">@xemahq/kernel-contracts</text>
+  <text x="92" y="80" font-family="ui-sans-serif,system-ui,sans-serif" font-size="15" fill="#94A3B8">Stable wire contracts for Xema kernel surfaces</text>
+  <text x="652" y="105" text-anchor="end" font-family="ui-sans-serif,system-ui,sans-serif" font-size="12" fill="#475569">xema.dev</text>
+</svg>
+</p>
+
+<p align="center">
+  <a href="https://xema.dev">Website</a> &middot;
+  <a href="https://www.npmjs.com/package/@xemahq/kernel-contracts">npm</a>
+</p>
+
+<p align="center">
+  <img alt="npm" src="https://img.shields.io/npm/v/%40xemahq%2Fkernel-contracts?color=2563eb&label=npm">
+  <img alt="license" src="https://img.shields.io/npm/l/%40xemahq%2Fkernel-contracts?color=10b981">
+  <img alt="types" src="https://img.shields.io/npm/types/%40xemahq%2Fkernel-contracts?color=3178c6">
+</p>
+
+# @xemahq/kernel-contracts
+
+> Stable wire contracts for Xema kernel surfaces
+
+## Overview
+
+This package publishes Xema's framework-independent protocol types and schemas
+through stable per-surface entrypoints. It gives services, SDKs, and clients one
+source of truth for exchanging validated kernel data without introducing
+runtime or domain coupling. The `agent-launch` entrypoint defines the canonical
+tenant-fenced request and authority-narrowing helpers used by every surface that
+starts a full Agent; `agent-catalog` defines the strict, revision-pinned active
+Agent discovery projection and cursor query; `invocation` wraps that launch
+request with delivery/output semantics and publishes one durable, pinned
+lifecycle record for synchronous, asynchronous and event delivery; `model`
+owns the runtime-neutral model reference vocabulary.
+
+The `biome` entrypoint owns the v4 `xema-biome.json` contract. Every manifest
+declares stable `components[]` with a closed kind, portable artifact and wire
+protocol, supported host ABI/execution modes, and component-local requirements.
+Authors never declare physical ports, pods, runners, credentials, provider
+endpoints, or Kubernetes topology. The generated JSON Schema is exported as
+`@xemahq/kernel-contracts/biome/xema-biome.schema.json`; TypeScript types are
+inferred from the same Zod source.
+
+## When to use it
+
+- Use it when producing or consuming a public Xema kernel protocol surface.
+- Import the narrow subpath for the contract domain you need.
+
+## Installation
+
+```bash
+pnpm add @xemahq/kernel-contracts
+```
+
+## License
+
+Apache-2.0 &copy; Xema — [xema.dev](https://xema.dev)

package/dist/.source-stamp.json

@@ -0,0 +1,5 @@
+{
+  "algorithm": "sha256/len-framed-v1",
+  "hash": "40e2805ead85c1c69880559e329dd13d3de0b2faaaad452e98f2859e8bd875d6",
+  "fileCount": 513
+}

package/dist/address/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/xema-address';
+export * from './lib/resource-instance-address';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/address/index.ts"],"names":[],"mappings":"AAoBA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC"}

package/dist/address/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/xema-address"), exports);
+__exportStar(require("./lib/resource-instance-address"), exports);
+//# sourceMappingURL=index.js.map

package/dist/address/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/address/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAoBA,qDAAmC;AACnC,kEAAgD"}

package/dist/address/lib/resource-instance-address.d.ts

@@ -0,0 +1,15 @@
+export interface ResourceInstanceAddress {
+    readonly type: string;
+    readonly id: string;
+    readonly orgId?: string;
+}
+export declare class ResourceInstanceAddressError extends Error {
+    readonly code = "RESOURCE_REF_MALFORMED";
+    readonly ref: string;
+    readonly reason: string;
+    constructor(ref: string, reason: string);
+}
+export declare function parseResourceInstanceAddress(ref: string): ResourceInstanceAddress;
+export declare function tryParseResourceInstanceAddress(ref: string): ResourceInstanceAddress | null;
+export declare function isResourceInstanceAddress(ref: string): boolean;
+//# sourceMappingURL=resource-instance-address.d.ts.map

package/dist/address/lib/resource-instance-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-instance-address.d.ts","sourceRoot":"","sources":["../../../src/address/lib/resource-instance-address.ts"],"names":[],"mappings":"AAqFA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAgB,IAAI,4BAA4B;IAChD,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEZ,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM/C;AAmBD,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,GACV,uBAAuB,CAgCzB;AAYD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,GACV,uBAAuB,GAAG,IAAI,CAMhC;AAGD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/address/lib/resource-instance-address.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceInstanceAddressError = void 0;
+exports.parseResourceInstanceAddress = parseResourceInstanceAddress;
+exports.tryParseResourceInstanceAddress = tryParseResourceInstanceAddress;
+exports.isResourceInstanceAddress = isResourceInstanceAddress;
+const object_1 = require("../../object");
+const resource_1 = require("../../resource");
+const xema_address_1 = require("./xema-address");
+class ResourceInstanceAddressError extends Error {
+    code = 'RESOURCE_REF_MALFORMED';
+    ref;
+    reason;
+    constructor(ref, reason) {
+        super(`Invalid resource instance ref "${ref}": ${reason}`);
+        this.name = 'ResourceInstanceAddressError';
+        this.ref = ref;
+        this.reason = reason;
+    }
+}
+exports.ResourceInstanceAddressError = ResourceInstanceAddressError;
+const ACCEPTED_FORMS = 'expected the canonical "xema://<scope>/resource/<type>/<id>[@<version>]" ' +
+    'or the legacy "resource:<type>:<id>"';
+function parseResourceInstanceAddress(ref) {
+    const address = (0, xema_address_1.parseXemaAddress)(ref);
+    if (address === null) {
+        throw new ResourceInstanceAddressError(String(ref), `empty ref — ${ACCEPTED_FORMS}`);
+    }
+    if (address.kind === xema_address_1.XemaAddressKind.Object) {
+        return fromObjectRef(address.ref);
+    }
+    if (address.kind === xema_address_1.XemaAddressKind.Resource) {
+        try {
+            const { type, id } = (0, resource_1.parseResourceRef)(address.ref);
+            return { type, id };
+        }
+        catch (error) {
+            throw new ResourceInstanceAddressError(address.ref, error instanceof Error ? error.message : String(error));
+        }
+    }
+    throw new ResourceInstanceAddressError(address.ref, `is a ${address.kind} address — ${ACCEPTED_FORMS}`);
+}
+function tryParseResourceInstanceAddress(ref) {
+    try {
+        return parseResourceInstanceAddress(ref);
+    }
+    catch {
+        return null;
+    }
+}
+function isResourceInstanceAddress(ref) {
+    return tryParseResourceInstanceAddress(ref) !== null;
+}
+function fromObjectRef(ref) {
+    let parts;
+    try {
+        parts = (0, object_1.parseXemaObjectRef)(ref);
+    }
+    catch (error) {
+        throw new ResourceInstanceAddressError(ref, error instanceof Error ? error.message : String(error));
+    }
+    if ((0, object_1.formatXemaObjectRef)(parts) !== ref) {
+        throw new ResourceInstanceAddressError(ref, `must use its canonical rendering ("${(0, object_1.formatXemaObjectRef)(parts)}")`);
+    }
+    if (parts.kind !== object_1.XemaObjectKind.Resource) {
+        throw new ResourceInstanceAddressError(ref, `names a "${parts.kind}" object, not a resource instance`);
+    }
+    const [type, ...idSegments] = parts.slug.split('/');
+    const id = idSegments.join('/');
+    if (type === undefined || type.length === 0 || id.length === 0) {
+        throw new ResourceInstanceAddressError(ref, 'resource slug must be "<type>/<id>" with both segments non-empty');
+    }
+    return parts.scope.orgId === undefined
+        ? { type, id }
+        : { type, id, orgId: parts.scope.orgId };
+}
+//# sourceMappingURL=resource-instance-address.js.map

package/dist/address/lib/resource-instance-address.js.map

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

package/dist/address/lib/xema-address.d.ts

@@ -0,0 +1,13 @@
+export declare enum XemaAddressKind {
+    Object = "object",
+    Resource = "resource",
+    Capability = "capability",
+    Opaque = "opaque"
+}
+export interface ParsedXemaAddress {
+    readonly ref: string;
+    readonly kind: XemaAddressKind;
+    readonly family: string | null;
+}
+export declare function parseXemaAddress(ref: string | null | undefined): ParsedXemaAddress | null;
+//# sourceMappingURL=xema-address.d.ts.map

package/dist/address/lib/xema-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xema-address.d.ts","sourceRoot":"","sources":["../../../src/address/lib/xema-address.ts"],"names":[],"mappings":"AAwGA,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAK/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAiED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,iBAAiB,GAAG,IAAI,CA6C1B"}

package/dist/address/lib/xema-address.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XemaAddressKind = void 0;
+exports.parseXemaAddress = parseXemaAddress;
+const capability_1 = require("../../capability");
+const object_1 = require("../../object");
+const resource_1 = require("../../resource");
+const XEMA_OBJECT_SCHEME = 'xema://';
+const KERNEL_RESOURCE_REF_PREFIX = 'resource:';
+const MAX_FAMILY_LENGTH = 64;
+var XemaAddressKind;
+(function (XemaAddressKind) {
+    XemaAddressKind["Object"] = "object";
+    XemaAddressKind["Resource"] = "resource";
+    XemaAddressKind["Capability"] = "capability";
+    XemaAddressKind["Opaque"] = "opaque";
+})(XemaAddressKind || (exports.XemaAddressKind = XemaAddressKind = {}));
+function boundedFamily(family) {
+    if (family === undefined || family.length === 0) {
+        return null;
+    }
+    return family.length > MAX_FAMILY_LENGTH ? null : family;
+}
+function familyOfObjectRef(ref) {
+    let parts;
+    try {
+        parts = (0, object_1.parseXemaObjectRef)(ref);
+    }
+    catch {
+        return null;
+    }
+    if (parts.kind !== object_1.XemaObjectKind.Resource) {
+        return boundedFamily(parts.kind);
+    }
+    return boundedFamily(parts.slug.split('/')[0]);
+}
+function familyOfKernelResourceRef(ref) {
+    try {
+        return boundedFamily((0, resource_1.parseResourceRef)(ref).type);
+    }
+    catch {
+        return null;
+    }
+}
+function parseXemaAddress(ref) {
+    if (ref === null || ref === undefined) {
+        return null;
+    }
+    const trimmed = ref.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    if (trimmed.startsWith(XEMA_OBJECT_SCHEME)) {
+        return {
+            ref: trimmed,
+            kind: XemaAddressKind.Object,
+            family: familyOfObjectRef(trimmed),
+        };
+    }
+    if (trimmed.startsWith(KERNEL_RESOURCE_REF_PREFIX)) {
+        return {
+            ref: trimmed,
+            kind: XemaAddressKind.Resource,
+            family: familyOfKernelResourceRef(trimmed),
+        };
+    }
+    const separator = trimmed.indexOf(':');
+    const prefixFamily = separator <= 0 ? null : boundedFamily(trimmed.slice(0, separator));
+    if (capability_1.CapabilityRefSchema.safeParse(trimmed).success) {
+        return {
+            ref: trimmed,
+            kind: XemaAddressKind.Capability,
+            family: prefixFamily,
+        };
+    }
+    return { ref: trimmed, kind: XemaAddressKind.Opaque, family: prefixFamily };
+}
+//# sourceMappingURL=xema-address.js.map

package/dist/address/lib/xema-address.js.map

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

package/dist/agent-composition/index.d.ts

@@ -0,0 +1,11 @@
+export * from './lib/capability-layer';
+export * from './lib/agent';
+export * from './lib/agent-ref-resolution';
+export * from '../agent-execution-mode';
+export * from './lib/agent-limits-schema';
+export * from './lib/agent-workspace-config';
+export * from './lib/intrinsic-floor';
+export * from '../session-launch';
+export * from './lib/launch-definition';
+export * from './lib/model-resolution-matrix';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-composition/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":"AAWA,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAI3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC"}

package/dist/agent-composition/index.js

@@ -0,0 +1,27 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/capability-layer"), exports);
+__exportStar(require("./lib/agent"), exports);
+__exportStar(require("./lib/agent-ref-resolution"), exports);
+__exportStar(require("../agent-execution-mode"), exports);
+__exportStar(require("./lib/agent-limits-schema"), exports);
+__exportStar(require("./lib/agent-workspace-config"), exports);
+__exportStar(require("./lib/intrinsic-floor"), exports);
+__exportStar(require("../session-launch"), exports);
+__exportStar(require("./lib/launch-definition"), exports);
+__exportStar(require("./lib/model-resolution-matrix"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agent-composition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,yDAAuC;AACvC,8CAA4B;AAC5B,6DAA2C;AAI3C,0DAAwC;AACxC,4DAA0C;AAC1C,+DAA6C;AAC7C,wDAAsC;AAGtC,oDAAkC;AAClC,0DAAwC;AACxC,gEAA8C"}

package/dist/agent-composition/lib/agent-limits-schema.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import type { AgentLimits } from './agent';
+export declare const AgentLimitsSchema: z.ZodType<AgentLimits>;
+//# sourceMappingURL=agent-limits-schema.d.ts.map

package/dist/agent-composition/lib/agent-limits-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-limits-schema.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-limits-schema.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAkB3C,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAM1C,CAAC"}

package/dist/agent-composition/lib/agent-limits-schema.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLimitsSchema = void 0;
+const zod_1 = require("zod");
+exports.AgentLimitsSchema = zod_1.z
+    .object({
+    maxDepth: zod_1.z.number().int().positive(),
+    maxSpawns: zod_1.z.number().int().positive(),
+    tokenBudget: zod_1.z.number().int().positive().optional(),
+})
+    .strict();
+//# sourceMappingURL=agent-limits-schema.js.map

package/dist/agent-composition/lib/agent-limits-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-limits-schema.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-limits-schema.ts"],"names":[],"mappings":";;;AAkCA,6BAAwB;AAoBX,QAAA,iBAAiB,GAA2B,OAAC;KACvD,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACpD,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/agent-composition/lib/agent-ref-resolution.d.ts

@@ -0,0 +1,20 @@
+import type { AgentRef } from './agent';
+export interface ResolvedAgentRef extends AgentRef {
+    readonly version: string;
+}
+export interface UnresolvedAgentRefSite {
+    readonly path: string;
+    readonly slug: string;
+}
+export declare class UnresolvedAgentRefError extends Error {
+    readonly sites: readonly UnresolvedAgentRefSite[];
+    constructor(sites: readonly UnresolvedAgentRefSite[]);
+}
+export declare function isResolvedAgentRef(ref: AgentRef): ref is ResolvedAgentRef;
+export interface AgentRefBearingNode {
+    readonly kernel: AgentRef;
+    readonly children?: readonly AgentRefBearingNode[] | undefined;
+}
+export declare function collectUnresolvedAgentRefs(nodes: readonly AgentRefBearingNode[] | undefined, basePath?: string): UnresolvedAgentRefSite[];
+export declare function assertAgentSubagentTreeResolved(nodes: readonly AgentRefBearingNode[] | undefined, basePath?: string): void;
+//# sourceMappingURL=agent-ref-resolution.d.ts.map

package/dist/agent-composition/lib/agent-ref-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ref-resolution.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-ref-resolution.ts"],"names":[],"mappings":"AAoEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AASxC,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AASD,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAUD,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;gBAEtC,KAAK,EAAE,SAAS,sBAAsB,EAAE;CAW5D;AAaD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,GAAG,IAAI,gBAAgB,CAEzE;AAWD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAC;CAChE;AASD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,EACjD,QAAQ,SAAc,GACrB,sBAAsB,EAAE,CAmB1B;AAYD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,EACjD,QAAQ,SAAc,GACrB,IAAI,CAKN"}

package/dist/agent-composition/lib/agent-ref-resolution.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnresolvedAgentRefError = void 0;
+exports.isResolvedAgentRef = isResolvedAgentRef;
+exports.collectUnresolvedAgentRefs = collectUnresolvedAgentRefs;
+exports.assertAgentSubagentTreeResolved = assertAgentSubagentTreeResolved;
+class UnresolvedAgentRefError extends Error {
+    sites;
+    constructor(sites) {
+        super(`Agent composition carries ${sites.length} sub-agent reference(s) with no pinned revision: ` +
+            `${sites.map((site) => `${site.path} -> "${site.slug}"`).join(', ')}. ` +
+            'A published Agent revision is immutable, so every reference inside it must name an ' +
+            'exact revision (`slug@<revisionNumber>`); publication resolves an authored bare slug ' +
+            'to the revision that was stable at publish time.');
+        this.name = 'UnresolvedAgentRefError';
+        this.sites = sites;
+    }
+}
+exports.UnresolvedAgentRefError = UnresolvedAgentRefError;
+function isResolvedAgentRef(ref) {
+    return typeof ref.version === 'string' && ref.version.length > 0;
+}
+function collectUnresolvedAgentRefs(nodes, basePath = 'subagents') {
+    const sites = [];
+    const walk = (level, path) => {
+        if (level === undefined) {
+            return;
+        }
+        level.forEach((node, index) => {
+            const here = `${path}[${index}]`;
+            if (!isResolvedAgentRef(node.kernel)) {
+                sites.push({ path: here, slug: node.kernel.slug });
+            }
+            walk(node.children, `${here}.subagents`);
+        });
+    };
+    walk(nodes, basePath);
+    return sites;
+}
+function assertAgentSubagentTreeResolved(nodes, basePath = 'subagents') {
+    const sites = collectUnresolvedAgentRefs(nodes, basePath);
+    if (sites.length > 0) {
+        throw new UnresolvedAgentRefError(sites);
+    }
+}
+//# sourceMappingURL=agent-ref-resolution.js.map

package/dist/agent-composition/lib/agent-ref-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ref-resolution.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-ref-resolution.ts"],"names":[],"mappings":";;;AAkIA,gDAEC;AAuBD,gEAsBC;AAYD,0EAQC;AA9FD,MAAa,uBAAwB,SAAQ,KAAK;IAChC,KAAK,CAAoC;IAEzD,YAAmB,KAAwC;QACzD,KAAK,CACH,6BAA6B,KAAK,CAAC,MAAM,mDAAmD;YAC1F,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACvE,qFAAqF;YACrF,uFAAuF;YACvF,kDAAkD,CACrD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAdD,0DAcC;AAaD,SAAgB,kBAAkB,CAAC,GAAa;IAC9C,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AACnE,CAAC;AAuBD,SAAgB,0BAA0B,CACxC,KAAiD,EACjD,QAAQ,GAAG,WAAW;IAEtB,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,CACX,KAAiD,EACjD,IAAY,EACN,EAAE;QACR,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;YACjC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,YAAY,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtB,OAAO,KAAK,CAAC;AACf,CAAC;AAYD,SAAgB,+BAA+B,CAC7C,KAAiD,EACjD,QAAQ,GAAG,WAAW;IAEtB,MAAM,KAAK,GAAG,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/agent-composition/lib/agent-workspace-config.d.ts

@@ -0,0 +1,37 @@
+import type { WorkingFileBinding, WorkspaceEnvVar, WorkspacePersistenceSpec } from '../../agent-workspace';
+import type { AgentRunRole, CompiledManifestCredential, CompiledManifestPermissions, OutputSurfaceKind } from '../../workflow';
+export type { WorkingFileBinding, WorkspaceEnvVar, WorkspacePersistenceSpec, } from '../../agent-workspace';
+export declare enum AgentOutputSurfaceMode {
+    Single = "single",
+    Multi = "multi"
+}
+export interface AgentOutputSurface {
+    readonly kind: OutputSurfaceKind;
+    readonly port?: number;
+    readonly healthPath?: string;
+    readonly autoOpen?: boolean;
+    readonly mode?: AgentOutputSurfaceMode;
+    readonly root?: string;
+    readonly defaultDocument?: string;
+}
+export interface AgentRunConfig {
+    readonly stage: string;
+    readonly role: AgentRunRole;
+    readonly deliverableSpecRef?: string;
+}
+export interface AgentMountLayout {
+    readonly mounts: Readonly<Record<string, unknown>>;
+    readonly agentRunConfig: AgentRunConfig;
+    readonly seedFiles: readonly Readonly<Record<string, unknown>>[];
+    readonly inputs: Readonly<Record<string, unknown>>;
+}
+export interface AgentWorkspaceConfig {
+    readonly persistence?: WorkspacePersistenceSpec;
+    readonly env?: readonly WorkspaceEnvVar[];
+    readonly outputSurface?: AgentOutputSurface;
+    readonly mountLayout?: AgentMountLayout;
+    readonly workingFiles?: readonly WorkingFileBinding[];
+    readonly credentials?: readonly CompiledManifestCredential[];
+    readonly permissions?: CompiledManifestPermissions;
+}
+//# sourceMappingURL=agent-workspace-config.d.ts.map

package/dist/agent-composition/lib/agent-workspace-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workspace-config.d.ts","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-workspace-config.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,YAAY,EACZ,0BAA0B,EAC1B,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAQ/B,oBAAY,sBAAsB;IAChC,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAsBD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAMvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAMvB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAcD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AA6BD,MAAM,WAAW,gBAAgB;IAO/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAOxC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAOjE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAQD,MAAM,WAAW,oBAAoB;IAKnC,QAAQ,CAAC,WAAW,CAAC,EAAE,wBAAwB,CAAC;IAOhD,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAK1C,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAQ5C,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAgBxC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAWtD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAW7D,QAAQ,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC;CACpD"}

package/dist/agent-composition/lib/agent-workspace-config.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentOutputSurfaceMode = void 0;
+var AgentOutputSurfaceMode;
+(function (AgentOutputSurfaceMode) {
+    AgentOutputSurfaceMode["Single"] = "single";
+    AgentOutputSurfaceMode["Multi"] = "multi";
+})(AgentOutputSurfaceMode || (exports.AgentOutputSurfaceMode = AgentOutputSurfaceMode = {}));
+//# sourceMappingURL=agent-workspace-config.js.map

package/dist/agent-composition/lib/agent-workspace-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workspace-config.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent-workspace-config.ts"],"names":[],"mappings":";;;AA6CA,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,yCAAe,CAAA;AACjB,CAAC,EAHW,sBAAsB,sCAAtB,sBAAsB,QAGjC"}

package/dist/agent-composition/lib/agent.d.ts

@@ -0,0 +1,70 @@
+import { SpaceKind, type SpaceKindSubset } from '../../space';
+import type { ToolSelectionEntry } from '../../mcp-tool';
+import type { NodeOverlayFragment, PromptMergeMode } from '../../workflow';
+import type { SkillRef } from '../../skill';
+import type { BiomeAvailabilityScoped } from '../../biome-availability';
+import type { AgentReachTier, StandingSessionRef, WorkspaceSharingPolicy } from '../../session-launch';
+import type { CapabilityLayer } from './capability-layer';
+import type { AgentWorkspaceConfig } from './agent-workspace-config';
+export interface AgentRef {
+    readonly slug: string;
+    readonly version?: string;
+}
+export declare const AGENT_SPACE_KINDS: SpaceKindSubset;
+export declare enum AgentLifecycle {
+    Draft = "draft",
+    Published = "published"
+}
+export interface AgentLimits {
+    readonly maxDepth: number;
+    readonly maxSpawns: number;
+    readonly tokenBudget?: number | undefined;
+}
+export interface AgentNode extends NodeOverlayFragment, BiomeAvailabilityScoped {
+    readonly kernel: AgentRef;
+    readonly alias?: string;
+    readonly skills: readonly SkillRef[];
+    readonly tools: readonly ToolSelectionEntry[];
+    readonly children: readonly AgentNode[];
+    readonly limits?: AgentLimits;
+}
+export interface Agent {
+    readonly slug: string;
+    readonly version: string;
+    readonly displayName: string;
+    readonly description?: string;
+    readonly scope: SpaceKind;
+    readonly lifecycle: AgentLifecycle;
+    readonly reachTier?: AgentReachTier;
+    readonly systemPrompt?: string;
+    readonly extends?: string;
+    readonly promptMode?: PromptMergeMode;
+    readonly skills: readonly SkillRef[];
+    readonly tools: readonly ToolSelectionEntry[];
+    readonly subagents: readonly AgentNode[];
+    readonly limits?: AgentLimits;
+    readonly capability?: CapabilityLayer;
+    readonly workspace?: AgentWorkspaceConfig;
+    readonly workspaceSharing?: WorkspaceSharingPolicy;
+    readonly standingSession?: StandingSessionRef;
+}
+export interface ResolvedAgentNode extends NodeOverlayFragment, BiomeAvailabilityScoped {
+    readonly kernel: Required<AgentRef>;
+    readonly alias?: string;
+    readonly skills: readonly SkillRef[];
+    readonly tools: readonly ToolSelectionEntry[];
+    readonly children: readonly ResolvedAgentNode[];
+    readonly limits?: AgentLimits;
+}
+export interface ResolvedAgent {
+    readonly slug: string;
+    readonly version: string;
+    readonly displayName: string;
+    readonly scope: SpaceKind;
+    readonly root: ResolvedAgentNode;
+    readonly capability: CapabilityLayer;
+    readonly workspace?: AgentWorkspaceConfig;
+    readonly workspaceSharing?: WorkspaceSharingPolicy;
+    readonly standingSession?: StandingSessionRef;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent-composition/lib/agent.d.ts.map

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

package/dist/agent-composition/lib/agent.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLifecycle = exports.AGENT_SPACE_KINDS = void 0;
+const space_1 = require("../../space");
+exports.AGENT_SPACE_KINDS = (0, space_1.spaceKindSubset)(space_1.SpaceKind.System, space_1.SpaceKind.Biome, space_1.SpaceKind.Org, space_1.SpaceKind.Project, space_1.SpaceKind.User);
+var AgentLifecycle;
+(function (AgentLifecycle) {
+    AgentLifecycle["Draft"] = "draft";
+    AgentLifecycle["Published"] = "published";
+})(AgentLifecycle || (exports.AgentLifecycle = AgentLifecycle = {}));
+//# sourceMappingURL=agent.js.map

package/dist/agent-composition/lib/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/agent-composition/lib/agent.ts"],"names":[],"mappings":";;;AAgBA,uCAA+E;AA0DlE,QAAA,iBAAiB,GAAoB,IAAA,uBAAe,EAC/D,iBAAS,CAAC,MAAM,EAChB,iBAAS,CAAC,KAAK,EACf,iBAAS,CAAC,GAAG,EACb,iBAAS,CAAC,OAAO,EACjB,iBAAS,CAAC,IAAI,CACf,CAAC;AAuBF,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,yCAAuB,CAAA;AACzB,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}