@xemahq/kernel-contracts 0.7.0 → 0.8.0

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

@@ -1,7 +1,7 @@
 export * from './lib/capability-layer';
-export * from './lib/composition';
-export * from './lib/composition-limits-schema';
-export * from './lib/composition-workspace';
+export * from './lib/agent';
+export * from './lib/agent-limits-schema';
+export * from './lib/agent-workspace-config';
 export * from './lib/intrinsic-floor';
 export * from './lib/invocation-overlay';
 export * from './lib/model-resolution-matrix';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":"AAWA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC"}
+{"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,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC"}

package/dist/agent-composition/index.js

@@ -15,9 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/capability-layer"), exports);
-__exportStar(require("./lib/composition"), exports);
-__exportStar(require("./lib/composition-limits-schema"), exports);
-__exportStar(require("./lib/composition-workspace"), exports);
+__exportStar(require("./lib/agent"), exports);
+__exportStar(require("./lib/agent-limits-schema"), exports);
+__exportStar(require("./lib/agent-workspace-config"), exports);
 __exportStar(require("./lib/intrinsic-floor"), exports);
 __exportStar(require("./lib/invocation-overlay"), exports);
 __exportStar(require("./lib/model-resolution-matrix"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,yDAAuC;AACvC,oDAAkC;AAClC,kEAAgD;AAChD,8DAA4C;AAC5C,wDAAsC;AACtC,2DAAyC;AACzC,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-composition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,yDAAuC;AACvC,8CAA4B;AAC5B,4DAA0C;AAC1C,+DAA6C;AAC7C,wDAAsC;AACtC,2DAAyC;AACzC,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":"AAmBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAS3C,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAO1C,CAAC"}

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

@@ -0,0 +1,13 @@
+"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(),
+    maxFanout: 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":";;;AAmBA,6BAAwB;AAWX,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,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-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,65 @@
+import type { ToolSelectionEntry } from '../../mcp-tool';
+import type { NodeOverlayFragment } from '../../workflow';
+import type { SkillRef } from '../../skill';
+import type { BiomeAvailabilityScoped } from '../../biome-availability';
+import type { CapabilityLayer } from './capability-layer';
+import type { AgentWorkspaceConfig } from './agent-workspace-config';
+export interface AgentKernelRef {
+    readonly slug: string;
+    readonly version?: string;
+}
+export declare enum AgentSpace {
+    System = "system",
+    Biome = "biome",
+    Org = "org",
+    Project = "project",
+    User = "user"
+}
+export declare enum AgentLifecycle {
+    Draft = "draft",
+    Published = "published",
+    Archived = "archived"
+}
+export interface AgentLimits {
+    readonly maxDepth: number;
+    readonly maxFanout: number;
+    readonly maxSpawns: number;
+    readonly tokenBudget?: number | undefined;
+}
+export interface AgentNode extends NodeOverlayFragment, BiomeAvailabilityScoped {
+    readonly kernel: AgentKernelRef;
+    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: AgentSpace;
+    readonly lifecycle: AgentLifecycle;
+    readonly root: AgentNode;
+    readonly capability?: CapabilityLayer;
+    readonly workspace?: AgentWorkspaceConfig;
+}
+export interface ResolvedAgentNode extends NodeOverlayFragment, BiomeAvailabilityScoped {
+    readonly kernel: Required<AgentKernelRef>;
+    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: AgentSpace;
+    readonly root: ResolvedAgentNode;
+    readonly capability: CapabilityLayer;
+    readonly workspace?: AgentWorkspaceConfig;
+}
+//# 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,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLifecycle = exports.AgentSpace = void 0;
+var AgentSpace;
+(function (AgentSpace) {
+    AgentSpace["System"] = "system";
+    AgentSpace["Biome"] = "biome";
+    AgentSpace["Org"] = "org";
+    AgentSpace["Project"] = "project";
+    AgentSpace["User"] = "user";
+})(AgentSpace || (exports.AgentSpace = AgentSpace = {}));
+var AgentLifecycle;
+(function (AgentLifecycle) {
+    AgentLifecycle["Draft"] = "draft";
+    AgentLifecycle["Published"] = "published";
+    AgentLifecycle["Archived"] = "archived";
+})(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":";;;AAoCA,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,6BAAe,CAAA;IACf,yBAAW,CAAA;IACX,iCAAmB,CAAA;IACnB,2BAAa,CAAA;AACf,CAAC,EANW,UAAU,0BAAV,UAAU,QAMrB;AAQD,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,yCAAuB,CAAA;IACvB,uCAAqB,CAAA;AACvB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}

package/dist/agent-workspace/awp-spec.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://xema.dev/schemas/awp-spec.v1.json",
-  "emittedAt": "2026-06-14T22:25:44.904Z",
+  "emittedAt": "2026-06-15T10:11:32.411Z",
   "spec": {
     "id": "awp/v1",
     "version": "1.2.0",