@xemahq/kernel-contracts 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agent-composition/lib/capability-layer.d.ts +6 -6
- package/dist/agent-composition/lib/capability-layer.d.ts.map +1 -1
- package/dist/agent-composition/lib/capability-layer.js +3 -3
- package/dist/agent-composition/lib/capability-layer.js.map +1 -1
- package/dist/agent-composition/lib/composition-limits-schema.d.ts +2 -2
- package/dist/agent-composition/lib/composition-limits-schema.d.ts.map +1 -1
- package/dist/agent-composition/lib/composition-limits-schema.js +2 -2
- package/dist/agent-composition/lib/composition-limits-schema.js.map +1 -1
- package/dist/agent-composition/lib/composition-workspace.d.ts +9 -9
- package/dist/agent-composition/lib/composition-workspace.d.ts.map +1 -1
- package/dist/agent-composition/lib/composition-workspace.js +6 -6
- package/dist/agent-composition/lib/composition-workspace.js.map +1 -1
- package/dist/agent-composition/lib/composition.d.ts +22 -22
- package/dist/agent-composition/lib/composition.d.ts.map +1 -1
- package/dist/agent-composition/lib/composition.js +15 -15
- package/dist/agent-composition/lib/composition.js.map +1 -1
- package/dist/agent-workspace/awp-spec.json +1 -1
- package/dist/agent-workspace/index.d.ts +1 -1
- package/dist/agent-workspace/index.d.ts.map +1 -1
- package/dist/agent-workspace/index.js +1 -1
- package/dist/agent-workspace/index.js.map +1 -1
- package/dist/agent-workspace/lib/awp.d.ts +15 -0
- package/dist/agent-workspace/lib/awp.d.ts.map +1 -0
- package/dist/agent-workspace/lib/awp.js +197 -0
- package/dist/agent-workspace/lib/awp.js.map +1 -0
- package/dist/contribution/lib/contribution-kind.d.ts +1 -1
- package/dist/contribution/lib/contribution-kind.d.ts.map +1 -1
- package/dist/contribution/lib/contribution-kind.js +1 -1
- package/dist/contribution/lib/contribution-kind.js.map +1 -1
- package/dist/invocation/lib/invocation-record.d.ts +1 -1
- package/dist/invocation/lib/invocation-record.d.ts.map +1 -1
- package/dist/invocation/lib/invocation-record.js +1 -1
- package/dist/invocation/lib/invocation-record.js.map +1 -1
- package/dist/invocation/lib/invoke-request.d.ts +3 -3
- package/dist/invocation/lib/invoke-request.d.ts.map +1 -1
- package/dist/invocation/lib/invoke-request.js +3 -3
- package/dist/invocation/lib/invoke-request.js.map +1 -1
- package/dist/invocation/lib/invoke-response.d.ts +2 -2
- package/dist/invocation/lib/invoke-response.d.ts.map +1 -1
- package/dist/invocation/lib/invoke-response.js +2 -2
- package/dist/invocation/lib/invoke-response.js.map +1 -1
- package/dist/object/lib/xema-object-kind.d.ts +1 -1
- package/dist/object/lib/xema-object-kind.d.ts.map +1 -1
- package/dist/object/lib/xema-object-kind.js +1 -1
- package/dist/object/lib/xema-object-kind.js.map +1 -1
- package/dist/workflow/lib/mount-plan.d.ts +1 -1
- package/dist/workflow/lib/mount-plan.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/agent-composition/index.ts +2 -2
- package/src/agent-composition/lib/capability-layer.ts +9 -9
- package/src/agent-composition/lib/composition-limits-schema.ts +4 -4
- package/src/agent-composition/lib/composition-workspace.ts +18 -18
- package/src/agent-composition/lib/composition.ts +28 -28
- package/src/agent-composition/lib/invocation-overlay.ts +1 -1
- package/src/agent-workspace/index.ts +1 -1
- package/src/agent-workspace/lib/working-file.ts +1 -1
- package/src/agent-workspace/lib/workspace-spec.ts +3 -3
- package/src/biome-availability/lib/biome-availability.ts +3 -3
- package/src/contribution/lib/contribution-kind.ts +1 -1
- package/src/contribution/lib/contribution-source.ts +1 -1
- package/src/distribution/lib/distribution.ts +1 -1
- package/src/document-templates/lib/document-template.ts +1 -1
- package/src/invocation/lib/execution-requirements.ts +1 -1
- package/src/invocation/lib/invocation-mode.ts +1 -1
- package/src/invocation/lib/invocation-record.ts +2 -2
- package/src/invocation/lib/invoke-request.ts +7 -7
- package/src/invocation/lib/invoke-response.ts +3 -3
- package/src/object/lib/object-lifecycle.ts +1 -1
- package/src/object/lib/xema-object-kind.ts +2 -2
- package/src/object/lib/xema-object.ts +2 -2
- package/src/workflow/lib/compiled-run.ts +3 -3
- package/src/workflow/lib/compiled-workspace-manifest.ts +1 -1
- package/src/workflow/lib/model-ref.ts +1 -1
- package/src/workflow/lib/mount-plan.ts +1 -1
- /package/src/agent-workspace/lib/{awp-v1.ts → awp.ts} +0 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"invocation-record.d.ts","sourceRoot":"","sources":["../../../src/invocation/lib/invocation-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,
|
|
1
|
+
{"version":3,"file":"invocation-record.d.ts","sourceRoot":"","sources":["../../../src/invocation/lib/invocation-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,sBAAsB,EAoB7B,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC"}
|
|
@@ -7,7 +7,7 @@ const invocation_status_1 = require("./invocation-status");
|
|
|
7
7
|
const invocation_decision_1 = require("./invocation-decision");
|
|
8
8
|
exports.InvocationRecordSchema = zod_1.z.object({
|
|
9
9
|
id: zod_1.z.string().min(1),
|
|
10
|
-
|
|
10
|
+
agentRef: zod_1.z.string().min(1),
|
|
11
11
|
orgId: zod_1.z.string().min(1),
|
|
12
12
|
projectId: zod_1.z.string().min(1).nullable(),
|
|
13
13
|
threadKey: zod_1.z.string().min(1),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"invocation-record.js","sourceRoot":"","sources":["../../../src/invocation/lib/invocation-record.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uDAAyE;AACzE,2DAA+E;AAC/E,+DAG+B;AAgClB,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,
|
|
1
|
+
{"version":3,"file":"invocation-record.js","sourceRoot":"","sources":["../../../src/invocation/lib/invocation-record.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uDAAyE;AACzE,2DAA+E;AAC/E,+DAG+B;AAgClB,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,sCAAoB;IAC1B,MAAM,EAAE,0CAAsB;IAC9B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,8CAAwB,CAAC,CAAC,QAAQ,EAAE;IACvD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAChC,CAAgC,CAAC"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { ExecutionRequirements } from './execution-requirements';
|
|
3
|
-
export interface
|
|
4
|
-
readonly
|
|
3
|
+
export interface AgentInvokeRequest {
|
|
4
|
+
readonly agentRef: string;
|
|
5
5
|
readonly orgId: string;
|
|
6
6
|
readonly projectId?: string;
|
|
7
7
|
readonly threadKey: string;
|
|
@@ -9,5 +9,5 @@ export interface CompositionInvokeRequest {
|
|
|
9
9
|
readonly input: Record<string, unknown>;
|
|
10
10
|
readonly requirements: ExecutionRequirements;
|
|
11
11
|
}
|
|
12
|
-
export declare const
|
|
12
|
+
export declare const AgentInvokeRequestSchema: z.ZodType<AgentInvokeRequest>;
|
|
13
13
|
//# sourceMappingURL=invoke-request.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"invoke-request.d.ts","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AASlC,MAAM,WAAW,
|
|
1
|
+
{"version":3,"file":"invoke-request.d.ts","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AASlC,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;CAC9C;AAED,eAAO,MAAM,wBAAwB,EAQ/B,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC"}
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
3
|
+
exports.AgentInvokeRequestSchema = void 0;
|
|
4
4
|
const zod_1 = require("zod");
|
|
5
5
|
const execution_requirements_1 = require("./execution-requirements");
|
|
6
|
-
exports.
|
|
7
|
-
|
|
6
|
+
exports.AgentInvokeRequestSchema = zod_1.z.object({
|
|
7
|
+
agentRef: zod_1.z.string().min(1),
|
|
8
8
|
orgId: zod_1.z.string().min(1),
|
|
9
9
|
projectId: zod_1.z.string().min(1).optional(),
|
|
10
10
|
threadKey: zod_1.z.string().min(1),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"invoke-request.js","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-request.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAGkC;AAqBrB,QAAA,
|
|
1
|
+
{"version":3,"file":"invoke-request.js","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-request.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAGkC;AAqBrB,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;IACxC,YAAY,EAAE,oDAA2B;CAC1C,CAAkC,CAAC"}
|
|
@@ -2,7 +2,7 @@ import { z } from 'zod';
|
|
|
2
2
|
import { InvocationMode } from './invocation-mode';
|
|
3
3
|
import { InvocationStatus } from './invocation-status';
|
|
4
4
|
import { InvocationDecision } from './invocation-decision';
|
|
5
|
-
export interface
|
|
5
|
+
export interface AgentInvokeResponse {
|
|
6
6
|
readonly invocationId: string;
|
|
7
7
|
readonly status: InvocationStatus;
|
|
8
8
|
readonly mode: InvocationMode;
|
|
@@ -13,5 +13,5 @@ export interface CompositionInvokeResponse {
|
|
|
13
13
|
readonly modelRef?: string;
|
|
14
14
|
readonly auditId?: string;
|
|
15
15
|
}
|
|
16
|
-
export declare const
|
|
16
|
+
export declare const AgentInvokeResponseSchema: z.ZodType<AgentInvokeResponse>;
|
|
17
17
|
//# sourceMappingURL=invoke-response.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"invoke-response.d.ts","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAS/B,MAAM,WAAW,
|
|
1
|
+
{"version":3,"file":"invoke-response.d.ts","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAA0B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAS/B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,yBAAyB,EAUhC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC"}
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
3
|
+
exports.AgentInvokeResponseSchema = void 0;
|
|
4
4
|
const zod_1 = require("zod");
|
|
5
5
|
const invocation_mode_1 = require("./invocation-mode");
|
|
6
6
|
const invocation_status_1 = require("./invocation-status");
|
|
7
7
|
const invocation_decision_1 = require("./invocation-decision");
|
|
8
|
-
exports.
|
|
8
|
+
exports.AgentInvokeResponseSchema = zod_1.z.object({
|
|
9
9
|
invocationId: zod_1.z.string().min(1),
|
|
10
10
|
status: invocation_status_1.InvocationStatusSchema,
|
|
11
11
|
mode: invocation_mode_1.InvocationModeSchema,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"invoke-response.js","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-response.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uDAAyE;AACzE,2DAA+E;AAC/E,+DAG+B;AAsBlB,QAAA
|
|
1
|
+
{"version":3,"file":"invoke-response.js","sourceRoot":"","sources":["../../../src/invocation/lib/invoke-response.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uDAAyE;AACzE,2DAA+E;AAC/E,+DAG+B;AAsBlB,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,0CAAsB;IAC9B,IAAI,EAAE,sCAAoB;IAC1B,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,8CAAwB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAmC,CAAC"}
|
|
@@ -6,8 +6,8 @@ export declare enum XemaObjectKind {
|
|
|
6
6
|
AudiencePolicy = "audience-policy",
|
|
7
7
|
ExternalSubject = "external-subject",
|
|
8
8
|
DelegatedSession = "delegated-session",
|
|
9
|
+
AgentKernel = "agent-kernel",
|
|
9
10
|
Agent = "agent",
|
|
10
|
-
AgentComposition = "agent-composition",
|
|
11
11
|
Skill = "skill",
|
|
12
12
|
Tool = "tool",
|
|
13
13
|
Model = "model",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"xema-object-kind.d.ts","sourceRoot":"","sources":["../../../src/object/lib/xema-object-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,oBAAY,cAAc;IAExB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,SAAS,eAAe;IACxB,cAAc,oBAAoB;IAClC,eAAe,qBAAqB;IACpC,gBAAgB,sBAAsB;IAGtC,KAAK,UAAU;IACf,
|
|
1
|
+
{"version":3,"file":"xema-object-kind.d.ts","sourceRoot":"","sources":["../../../src/object/lib/xema-object-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,oBAAY,cAAc;IAExB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,SAAS,eAAe;IACxB,cAAc,oBAAoB;IAClC,eAAe,qBAAqB;IACpC,gBAAgB,sBAAsB;IAGtC,WAAW,iBAAiB;IAC5B,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,mBAAmB,0BAA0B;IAG7C,QAAQ,aAAa;IACrB,WAAW,iBAAiB;IAC5B,UAAU,gBAAgB;IAG1B,SAAS,cAAc;IACvB,gBAAgB,sBAAsB;IACtC,WAAW,iBAAiB;IAC5B,YAAY,kBAAkB;IAC9B,QAAQ,aAAa;IAGrB,cAAc,oBAAoB;IAClC,aAAa,mBAAmB;IAChC,gBAAgB,sBAAsB;IACtC,aAAa,mBAAmB;IAChC,YAAY,kBAAkB;IAC9B,mBAAmB,yBAAyB;IAC5C,UAAU,gBAAgB;IAG1B,UAAU,eAAe;IACzB,oBAAoB,0BAA0B;IAC9C,eAAe,qBAAqB;IACpC,YAAY,kBAAkB;IAG9B,MAAM,WAAW;IACjB,cAAc,oBAAoB;IAGlC,OAAO,YAAY;IACnB,WAAW,iBAAiB;IAC5B,iBAAiB,uBAAuB;IAGxC,iBAAiB,uBAAuB;IAGxC,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,oBAAoB,kCAA+B,CAAC"}
|
|
@@ -10,8 +10,8 @@ var XemaObjectKind;
|
|
|
10
10
|
XemaObjectKind["AudiencePolicy"] = "audience-policy";
|
|
11
11
|
XemaObjectKind["ExternalSubject"] = "external-subject";
|
|
12
12
|
XemaObjectKind["DelegatedSession"] = "delegated-session";
|
|
13
|
+
XemaObjectKind["AgentKernel"] = "agent-kernel";
|
|
13
14
|
XemaObjectKind["Agent"] = "agent";
|
|
14
|
-
XemaObjectKind["AgentComposition"] = "agent-composition";
|
|
15
15
|
XemaObjectKind["Skill"] = "skill";
|
|
16
16
|
XemaObjectKind["Tool"] = "tool";
|
|
17
17
|
XemaObjectKind["Model"] = "model";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"xema-object-kind.js","sourceRoot":"","sources":["../../../src/object/lib/xema-object-kind.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAYxB,IAAY,cA0DX;AA1DD,WAAY,cAAc;IAExB,iCAAe,CAAA;IACf,6BAAW,CAAA;IACX,0CAAwB,CAAA;IACxB,oDAAkC,CAAA;IAClC,sDAAoC,CAAA;IACpC,wDAAsC,CAAA;IAGtC,
|
|
1
|
+
{"version":3,"file":"xema-object-kind.js","sourceRoot":"","sources":["../../../src/object/lib/xema-object-kind.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAYxB,IAAY,cA0DX;AA1DD,WAAY,cAAc;IAExB,iCAAe,CAAA;IACf,6BAAW,CAAA;IACX,0CAAwB,CAAA;IACxB,oDAAkC,CAAA;IAClC,sDAAoC,CAAA;IACpC,wDAAsC,CAAA;IAGtC,8CAA4B,CAAA;IAC5B,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,+BAAa,CAAA;IACb,iCAAe,CAAA;IACf,+DAA6C,CAAA;IAG7C,uCAAqB,CAAA;IACrB,8CAA4B,CAAA;IAC5B,4CAA0B,CAAA;IAG1B,yCAAuB,CAAA;IACvB,wDAAsC,CAAA;IACtC,8CAA4B,CAAA;IAC5B,gDAA8B,CAAA;IAC9B,uCAAqB,CAAA;IAGrB,oDAAkC,CAAA;IAClC,kDAAgC,CAAA;IAChC,wDAAsC,CAAA;IACtC,kDAAgC,CAAA;IAChC,gDAA8B,CAAA;IAC9B,8DAA4C,CAAA;IAC5C,4CAA0B,CAAA;IAG1B,2CAAyB,CAAA;IACzB,gEAA8C,CAAA;IAC9C,sDAAoC,CAAA;IACpC,gDAA8B,CAAA;IAG9B,mCAAiB,CAAA;IACjB,oDAAkC,CAAA;IAGlC,qCAAmB,CAAA;IACnB,8CAA4B,CAAA;IAC5B,0DAAwC,CAAA;IAGxC,0DAAwC,CAAA;IAGxC,qCAAmB,CAAA;AACrB,CAAC,EA1DW,cAAc,8BAAd,cAAc,QA0DzB;AAEY,QAAA,oBAAoB,GAAG,OAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC"}
|
|
@@ -50,7 +50,7 @@ export type MountSource = {
|
|
|
50
50
|
readonly pathWithinWorkspace: string;
|
|
51
51
|
readonly bytes: string;
|
|
52
52
|
} | {
|
|
53
|
-
readonly kind: 'agent-
|
|
53
|
+
readonly kind: 'agent-kernel';
|
|
54
54
|
readonly orgId: string;
|
|
55
55
|
readonly agentSlug: string;
|
|
56
56
|
readonly stageKey: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mount-plan.d.ts","sourceRoot":"","sources":["../../../src/workflow/lib/mount-plan.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAE/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAQD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,YAAY,EAAE,YAAY,EAAE,CAAC;AAa7B,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7E;IAeE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAS5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD;IAaE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAEjG;IACE,QAAQ,CAAC,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"mount-plan.d.ts","sourceRoot":"","sources":["../../../src/workflow/lib/mount-plan.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xemahq/kernel-contracts",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the 32 kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework/runtime deps.",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"registry": "https://registry.npmjs.org/",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// ═══════════════════════════════════════════════════════════════════════════
|
|
2
|
-
// ── Agent
|
|
2
|
+
// ── Agent Contracts — Barrel Export ──
|
|
3
3
|
//
|
|
4
|
-
// Kernel (Layer 1) contracts for the Agent
|
|
4
|
+
// Kernel (Layer 1) contracts for the Agent primitive and the
|
|
5
5
|
// Model Resolution Matrix. Pure types + closed enums — zero runtime deps,
|
|
6
6
|
// no NestJS, no Prisma.
|
|
7
7
|
//
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// ═══════════════════════════════════════════════════════════════════════════
|
|
2
2
|
// ── CapabilityLayer ──
|
|
3
3
|
//
|
|
4
|
-
// The capability envelope attached to an Agent
|
|
4
|
+
// The capability envelope attached to an Agent: what the
|
|
5
5
|
// composition is allowed to do at runtime (write policy, repo access,
|
|
6
6
|
// knowledge-base writes, allowed Xema-namespaced tools).
|
|
7
7
|
//
|
|
@@ -16,30 +16,30 @@
|
|
|
16
16
|
* - `own-pages-only`: may only write declared deliverable files.
|
|
17
17
|
* - `full-write`: may write anywhere the workspace permits.
|
|
18
18
|
*/
|
|
19
|
-
export const
|
|
19
|
+
export const AGENT_WRITE_POLICIES = [
|
|
20
20
|
'read-only',
|
|
21
21
|
'own-pages-only',
|
|
22
22
|
'full-write',
|
|
23
23
|
] as const;
|
|
24
|
-
export type
|
|
25
|
-
(typeof
|
|
24
|
+
export type AgentWritePolicy =
|
|
25
|
+
(typeof AGENT_WRITE_POLICIES)[number];
|
|
26
26
|
|
|
27
27
|
/**
|
|
28
28
|
* Repo-write capability.
|
|
29
29
|
* - `never`: blanket deny repo writes.
|
|
30
30
|
* - `when-granted`: repo writes allowed iff the dispatch supplied repo slugs.
|
|
31
31
|
*/
|
|
32
|
-
export const
|
|
33
|
-
export type
|
|
34
|
-
(typeof
|
|
32
|
+
export const AGENT_REPO_POLICIES = ['never', 'when-granted'] as const;
|
|
33
|
+
export type AgentRepoPolicy =
|
|
34
|
+
(typeof AGENT_REPO_POLICIES)[number];
|
|
35
35
|
|
|
36
36
|
/**
|
|
37
37
|
* The capability envelope of a composition node. Resolved into each
|
|
38
38
|
* invocation's `context.json` authority block.
|
|
39
39
|
*/
|
|
40
40
|
export interface CapabilityLayer {
|
|
41
|
-
readonly writePolicy:
|
|
42
|
-
readonly mayEditRepos:
|
|
41
|
+
readonly writePolicy: AgentWritePolicy;
|
|
42
|
+
readonly mayEditRepos: AgentRepoPolicy;
|
|
43
43
|
readonly mayWriteKnowledgeBase: boolean;
|
|
44
44
|
/** Closed allowlist of Xema-namespaced tools (e.g. `xema_memory_set`). */
|
|
45
45
|
readonly allowedXemaTools: readonly string[];
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// ═══════════════════════════════════════════════════════════════════════════
|
|
2
|
-
// ──
|
|
2
|
+
// ── AgentLimits — Zod schema ──
|
|
3
3
|
//
|
|
4
4
|
// Validates the runtime envelope a coordinator-style composition node
|
|
5
5
|
// declares on itself (and inherits to descendants). Used by:
|
|
@@ -19,16 +19,16 @@
|
|
|
19
19
|
|
|
20
20
|
import { z } from 'zod';
|
|
21
21
|
|
|
22
|
-
import type {
|
|
22
|
+
import type { AgentLimits } from './composition';
|
|
23
23
|
|
|
24
24
|
/**
|
|
25
|
-
* Zod schema for {@link
|
|
25
|
+
* Zod schema for {@link AgentLimits}. Structural counters
|
|
26
26
|
* (`maxDepth` / `maxFanout` / `maxSpawns`) are strict positive integers.
|
|
27
27
|
* `tokenBudget` is optional; when omitted, the enforcer treats it as
|
|
28
28
|
* unlimited (no token-budget check). Authors who want NO enforcement at
|
|
29
29
|
* all must omit the entire `limits` block.
|
|
30
30
|
*/
|
|
31
|
-
export const
|
|
31
|
+
export const AgentLimitsSchema: z.ZodType<AgentLimits> = z
|
|
32
32
|
.object({
|
|
33
33
|
maxDepth: z.number().int().positive(),
|
|
34
34
|
maxFanout: z.number().int().positive(),
|
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
// ═══════════════════════════════════════════════════════════════════════════
|
|
2
|
-
// ──
|
|
2
|
+
// ── Agent Workspace block ──
|
|
3
3
|
//
|
|
4
4
|
// The AUTHORED source of the workspace's filesystem-layout / persistence /
|
|
5
|
-
// environment configuration. A `
|
|
6
|
-
// tools (the recursive `
|
|
5
|
+
// environment configuration. A `Agent` arms an agent with skills +
|
|
6
|
+
// tools (the recursive `AgentNode` tree); the `workspace` block
|
|
7
7
|
// declares the SHAPE of `/workspace/` that agent runs inside —
|
|
8
8
|
// persist-paths, env vars, and the live output-surface.
|
|
9
9
|
//
|
|
10
10
|
// `WorkspaceSpec` (`@xemahq/agent-workspace-contracts`) is a DERIVED
|
|
11
|
-
// projection: the resolution service projects `
|
|
11
|
+
// projection: the resolution service projects `Agent.workspace`
|
|
12
12
|
// onto the resolved `WorkspaceSpec` so workspace-tree consumers read one
|
|
13
13
|
// resolved spec without re-resolving the composition.
|
|
14
14
|
//
|
|
15
15
|
// This block absorbs the layout/persistence/env portion of the retiring
|
|
16
16
|
// `WorkspaceManifest` — the agent/skill/tool-selection portion already
|
|
17
|
-
// moved to `
|
|
17
|
+
// moved to `AgentNode`. Templates (the manifest's Handlebars
|
|
18
18
|
// seed-files) become skill-bundle resources served by skill-registry-api,
|
|
19
19
|
// so they are NOT modelled here.
|
|
20
20
|
// ═══════════════════════════════════════════════════════════════════════════
|
|
@@ -43,7 +43,7 @@ export type {
|
|
|
43
43
|
* target and emit one gateway route per app — used by webapp studios
|
|
44
44
|
* that scaffold N apps under one composition.
|
|
45
45
|
*/
|
|
46
|
-
export enum
|
|
46
|
+
export enum AgentOutputSurfaceMode {
|
|
47
47
|
Single = 'single',
|
|
48
48
|
Multi = 'multi',
|
|
49
49
|
}
|
|
@@ -68,14 +68,14 @@ export enum CompositionOutputSurfaceMode {
|
|
|
68
68
|
* - `app` / `tunnel`: reserved for future surface kinds; field set
|
|
69
69
|
* mirrors `web`.
|
|
70
70
|
*/
|
|
71
|
-
export interface
|
|
71
|
+
export interface AgentOutputSurface {
|
|
72
72
|
readonly kind: OutputSurfaceKind;
|
|
73
73
|
readonly port?: number;
|
|
74
74
|
readonly healthPath?: string;
|
|
75
75
|
/** Auto-open the preview pane on first ready signal. */
|
|
76
76
|
readonly autoOpen?: boolean;
|
|
77
77
|
/** Single-port (default) vs. multi-app output surface. */
|
|
78
|
-
readonly mode?:
|
|
78
|
+
readonly mode?: AgentOutputSurfaceMode;
|
|
79
79
|
/**
|
|
80
80
|
* Workspace-relative directory served as a static site. Required and
|
|
81
81
|
* only meaningful when `kind === 'static'`. The DSL schema enforces
|
|
@@ -92,7 +92,7 @@ export interface CompositionOutputSurface {
|
|
|
92
92
|
|
|
93
93
|
/**
|
|
94
94
|
* The agent run-config the composer needs that is NOT carried by the
|
|
95
|
-
* `
|
|
95
|
+
* `AgentNode` tree. The node tree pins WHICH agent runs; these
|
|
96
96
|
* three fields pin the run FRAMING (stage + role + deliverable
|
|
97
97
|
* contract) the renderer + system-overlay are driven by.
|
|
98
98
|
*
|
|
@@ -102,7 +102,7 @@ export interface CompositionOutputSurface {
|
|
|
102
102
|
* the workspace pipeline resolves against the run's bind inputs (the
|
|
103
103
|
* same fail-fast interpolation grammar `env` values use).
|
|
104
104
|
*/
|
|
105
|
-
export interface
|
|
105
|
+
export interface AgentRunConfig {
|
|
106
106
|
readonly stage: string;
|
|
107
107
|
readonly role: AgentRunRole;
|
|
108
108
|
readonly deliverableSpecRef?: string;
|
|
@@ -135,7 +135,7 @@ export interface CompositionAgentRunConfig {
|
|
|
135
135
|
* fragments with the DSL's `WorkspaceManifestSchema` when it
|
|
136
136
|
* reconstructs + compiles the manifest.
|
|
137
137
|
*/
|
|
138
|
-
export interface
|
|
138
|
+
export interface AgentMountLayout {
|
|
139
139
|
/**
|
|
140
140
|
* Raw `spec.mounts` block — user-data mount declarations keyed by AWP
|
|
141
141
|
* slot key. Each value is the manifest DSL `ManifestMountDeclaration`
|
|
@@ -144,7 +144,7 @@ export interface CompositionMountLayout {
|
|
|
144
144
|
*/
|
|
145
145
|
readonly mounts: Readonly<Record<string, unknown>>;
|
|
146
146
|
/** Agent run-config (stage + role + deliverable contract). */
|
|
147
|
-
readonly agentRunConfig:
|
|
147
|
+
readonly agentRunConfig: AgentRunConfig;
|
|
148
148
|
/**
|
|
149
149
|
* Raw `spec.seedFiles` array — manifest DSL `ManifestSeedFile`
|
|
150
150
|
* entries (`{ path, slot?, template?, content?, vars? }`). `vars` may
|
|
@@ -162,12 +162,12 @@ export interface CompositionMountLayout {
|
|
|
162
162
|
}
|
|
163
163
|
|
|
164
164
|
/**
|
|
165
|
-
* Authored workspace-layout config carried on a `
|
|
165
|
+
* Authored workspace-layout config carried on a `Agent`. Every
|
|
166
166
|
* field is optional + additive — a composition that declares no
|
|
167
167
|
* `workspace` block produces a `WorkspaceSpec` with no projected
|
|
168
168
|
* `persistence` / `env` (the AWP base slots still apply).
|
|
169
169
|
*/
|
|
170
|
-
export interface
|
|
170
|
+
export interface AgentWorkspaceConfig {
|
|
171
171
|
/**
|
|
172
172
|
* Workspace-relative persist-paths + per-slot policy overrides.
|
|
173
173
|
* Authoritative SOURCE projected onto `WorkspaceSpec.persistence`.
|
|
@@ -184,15 +184,15 @@ export interface CompositionWorkspace {
|
|
|
184
184
|
* Output-surface declaration. Optional — omitted for
|
|
185
185
|
* compositions that do not expose an output surface.
|
|
186
186
|
*/
|
|
187
|
-
readonly outputSurface?:
|
|
187
|
+
readonly outputSurface?: AgentOutputSurface;
|
|
188
188
|
/**
|
|
189
189
|
* The user-data mount layout — which AWP slots the profile enables,
|
|
190
190
|
* per-slot mode, the agent run-config, and seed files. The residual
|
|
191
|
-
* the Agent
|
|
191
|
+
* the Agent primitive absorbed from `WorkspaceManifest`
|
|
192
192
|
* in Phase 10, Step 3d. Optional + additive — a composition with no
|
|
193
193
|
* `mountLayout` runs on the AWP base slots alone with no seed files.
|
|
194
194
|
*/
|
|
195
|
-
readonly mountLayout?:
|
|
195
|
+
readonly mountLayout?: AgentMountLayout;
|
|
196
196
|
/**
|
|
197
197
|
* Working files the platform materialises for this session.
|
|
198
198
|
*
|
|
@@ -226,7 +226,7 @@ export interface CompositionWorkspace {
|
|
|
226
226
|
* manifest. Same seed → compose → resolve path as {@link credentials};
|
|
227
227
|
* consumed by the environment resolver + resume drift detection.
|
|
228
228
|
* Optional + additive. Distinct from the per-node
|
|
229
|
-
* {@link
|
|
229
|
+
* {@link AgentNode.permission} overlay — this is the workspace
|
|
230
230
|
* toolset policy, not the agent's permission map. Was silently DROPPED
|
|
231
231
|
* at seed before (BUG-1).
|
|
232
232
|
*/
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// ═══════════════════════════════════════════════════════════════════════════
|
|
2
|
-
// ── Agent
|
|
2
|
+
// ── Agent ──
|
|
3
3
|
//
|
|
4
4
|
// The recursive "workflow-as-agent" primitive: an Agent armed with Skills
|
|
5
5
|
// and Tools, whose sub-agents are themselves fully-armed composition nodes
|
|
@@ -18,12 +18,12 @@ import type { NodeOverlayFragment } from '../../workflow';
|
|
|
18
18
|
import type { SkillRef } from '../../skill';
|
|
19
19
|
import type { BiomeAvailabilityScoped } from '../../biome-availability';
|
|
20
20
|
import type { CapabilityLayer } from './capability-layer';
|
|
21
|
-
import type {
|
|
21
|
+
import type { AgentWorkspaceConfig } from './composition-workspace';
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
24
|
* A stable reference to an agent definition, optionally version-pinned.
|
|
25
25
|
*/
|
|
26
|
-
export interface
|
|
26
|
+
export interface AgentKernelRef {
|
|
27
27
|
readonly slug: string;
|
|
28
28
|
/** Pinned version; omitted = latest. */
|
|
29
29
|
readonly version?: string;
|
|
@@ -34,7 +34,7 @@ export interface AgentRef {
|
|
|
34
34
|
* is reusable. Mirrors `SkillSpace`; compositions are org-scoped so they
|
|
35
35
|
* are authored once and reused across projects.
|
|
36
36
|
*/
|
|
37
|
-
export enum
|
|
37
|
+
export enum AgentSpace {
|
|
38
38
|
System = 'system',
|
|
39
39
|
Biome = 'biome',
|
|
40
40
|
Org = 'org',
|
|
@@ -48,7 +48,7 @@ export enum CompositionSpace {
|
|
|
48
48
|
* - `published`: immutable; the only state resolution will serve.
|
|
49
49
|
* - `archived`: retired; kept for lineage but never resolved.
|
|
50
50
|
*/
|
|
51
|
-
export enum
|
|
51
|
+
export enum AgentLifecycle {
|
|
52
52
|
Draft = 'draft',
|
|
53
53
|
Published = 'published',
|
|
54
54
|
Archived = 'archived',
|
|
@@ -64,7 +64,7 @@ export enum CompositionLifecycle {
|
|
|
64
64
|
* declares the budget once and the whole subtree shares it.
|
|
65
65
|
*
|
|
66
66
|
* **Breach semantics — IMPORTANT:** any breach aborts the SSE stream and
|
|
67
|
-
* throws a non-retryable `ApplicationFailure(
|
|
67
|
+
* throws a non-retryable `ApplicationFailure(AGENT_BUDGET_EXCEEDED)`.
|
|
68
68
|
* The activity ends without emitting a deliverable; the harvester never
|
|
69
69
|
* runs. All in-flight work is lost — HITL re-dispatches from the prior
|
|
70
70
|
* gate. This is the right semantics for *structural* runaways (depth /
|
|
@@ -76,7 +76,7 @@ export enum CompositionLifecycle {
|
|
|
76
76
|
* unlimited. `maxDepth` / `maxFanout` / `maxSpawns` are the load-bearing
|
|
77
77
|
* structural caps.
|
|
78
78
|
*/
|
|
79
|
-
export interface
|
|
79
|
+
export interface AgentLimits {
|
|
80
80
|
/** Recursion depth ceiling — root = depth 0, first sub-agent = 1, etc. */
|
|
81
81
|
readonly maxDepth: number;
|
|
82
82
|
/** Concurrent `task()` spawns allowed per node within a single turn. */
|
|
@@ -100,11 +100,11 @@ export interface CompositionLimits {
|
|
|
100
100
|
* `skills` / `tools` / `modelOverride` attach AT this node — they extend or
|
|
101
101
|
* override what the referenced agent definition declares intrinsically.
|
|
102
102
|
*/
|
|
103
|
-
export interface
|
|
103
|
+
export interface AgentNode
|
|
104
104
|
extends NodeOverlayFragment,
|
|
105
105
|
BiomeAvailabilityScoped {
|
|
106
106
|
/** The agent definition this node runs. */
|
|
107
|
-
readonly
|
|
107
|
+
readonly kernel: AgentKernelRef;
|
|
108
108
|
/** Optional alias when the same agent appears more than once in the tree. */
|
|
109
109
|
readonly alias?: string;
|
|
110
110
|
/** Skills attached at this node. */
|
|
@@ -116,7 +116,7 @@ export interface CompositionNode
|
|
|
116
116
|
// OVERRIDE the model, APPEND to the base prompt, and RESTRICT-merge the
|
|
117
117
|
// permission for this node only.
|
|
118
118
|
/** Sub-agents — themselves fully-armed composition nodes (recursive). */
|
|
119
|
-
readonly children: readonly
|
|
119
|
+
readonly children: readonly AgentNode[];
|
|
120
120
|
/**
|
|
121
121
|
* Hard budget the runtime enforces against `task()` spawn telemetry
|
|
122
122
|
* for THIS node and every descendant it produces at runtime. Inherited
|
|
@@ -124,22 +124,22 @@ export interface CompositionNode
|
|
|
124
124
|
* limits once at the root. Absent root + absent descendants = no
|
|
125
125
|
* enforcement (today's pre-coordinator workflows).
|
|
126
126
|
*/
|
|
127
|
-
readonly limits?:
|
|
127
|
+
readonly limits?: AgentLimits;
|
|
128
128
|
}
|
|
129
129
|
|
|
130
130
|
/**
|
|
131
|
-
* A named, versioned, reusable Agent
|
|
131
|
+
* A named, versioned, reusable Agent.
|
|
132
132
|
*/
|
|
133
|
-
export interface
|
|
133
|
+
export interface Agent {
|
|
134
134
|
/** Stable slug; the identity within the registry. */
|
|
135
135
|
readonly slug: string;
|
|
136
136
|
readonly version: string;
|
|
137
137
|
readonly displayName: string;
|
|
138
138
|
readonly description?: string;
|
|
139
|
-
readonly scope:
|
|
140
|
-
readonly lifecycle:
|
|
139
|
+
readonly scope: AgentSpace;
|
|
140
|
+
readonly lifecycle: AgentLifecycle;
|
|
141
141
|
/** The root (primary) agent node. */
|
|
142
|
-
readonly root:
|
|
142
|
+
readonly root: AgentNode;
|
|
143
143
|
/** Capability envelope applied to the composition at runtime. */
|
|
144
144
|
readonly capability?: CapabilityLayer;
|
|
145
145
|
/**
|
|
@@ -150,23 +150,23 @@ export interface Composition {
|
|
|
150
150
|
* alone. Absorbs the layout/persistence/env portion of the retiring
|
|
151
151
|
* `WorkspaceManifest`.
|
|
152
152
|
*/
|
|
153
|
-
readonly workspace?:
|
|
153
|
+
readonly workspace?: AgentWorkspaceConfig;
|
|
154
154
|
}
|
|
155
155
|
|
|
156
156
|
/**
|
|
157
157
|
* The flattened, runtime-facing form of one resolved composition node.
|
|
158
|
-
* The resolution service produces this tree from a stored `
|
|
158
|
+
* The resolution service produces this tree from a stored `Agent`;
|
|
159
159
|
* the workspace/composer pipeline consumes it. Sub-agent nodes appear
|
|
160
160
|
* as `children` (still recursive) — each child is itself fully armed.
|
|
161
161
|
*
|
|
162
|
-
* Distinct from `
|
|
162
|
+
* Distinct from `AgentNode` (the AUTHORED form): a resolved node
|
|
163
163
|
* has its agent reference fully version-pinned, never `latest`.
|
|
164
164
|
*/
|
|
165
|
-
export interface
|
|
165
|
+
export interface ResolvedAgentNode
|
|
166
166
|
extends NodeOverlayFragment,
|
|
167
167
|
BiomeAvailabilityScoped {
|
|
168
168
|
/** Fully version-pinned agent reference. */
|
|
169
|
-
readonly
|
|
169
|
+
readonly kernel: Required<AgentKernelRef>;
|
|
170
170
|
readonly alias?: string;
|
|
171
171
|
/** Skill references attached at this node (version-pinned). */
|
|
172
172
|
readonly skills: readonly SkillRef[];
|
|
@@ -177,28 +177,28 @@ export interface ResolvedCompositionNode
|
|
|
177
177
|
// composer layers instructions onto the base systemPrompt and deep-merges
|
|
178
178
|
// permission over the agent's authored permission before the system tiers.
|
|
179
179
|
/** Resolved sub-agent nodes (recursive). */
|
|
180
|
-
readonly children: readonly
|
|
180
|
+
readonly children: readonly ResolvedAgentNode[];
|
|
181
181
|
/**
|
|
182
182
|
* Resolved budget for this node. The resolver propagates the nearest
|
|
183
|
-
* declared `limits` from the source `
|
|
183
|
+
* declared `limits` from the source `AgentNode` (root usually
|
|
184
184
|
* carries it; descendants inherit). Absent = no enforcement on this
|
|
185
185
|
* node and its descendants — preserves today's pre-coordinator
|
|
186
186
|
* workflow behaviour where no budget was declared.
|
|
187
187
|
*/
|
|
188
|
-
readonly limits?:
|
|
188
|
+
readonly limits?: AgentLimits;
|
|
189
189
|
}
|
|
190
190
|
|
|
191
191
|
/**
|
|
192
192
|
* The resolution service's output: a composition resolved against a task
|
|
193
193
|
* context, ready for the composer/workspace pipeline to consume.
|
|
194
194
|
*/
|
|
195
|
-
export interface
|
|
195
|
+
export interface ResolvedAgent {
|
|
196
196
|
readonly slug: string;
|
|
197
197
|
readonly version: string;
|
|
198
198
|
readonly displayName: string;
|
|
199
|
-
readonly scope:
|
|
199
|
+
readonly scope: AgentSpace;
|
|
200
200
|
/** Resolved root node — the primary agent. */
|
|
201
|
-
readonly root:
|
|
201
|
+
readonly root: ResolvedAgentNode;
|
|
202
202
|
/** Capability envelope applied to the whole composition at runtime. */
|
|
203
203
|
readonly capability: CapabilityLayer;
|
|
204
204
|
/**
|
|
@@ -207,5 +207,5 @@ export interface ResolvedComposition {
|
|
|
207
207
|
* interpolation in `env` values is already resolved here. The
|
|
208
208
|
* workspace pipeline projects this onto the run's `WorkspaceSpec`.
|
|
209
209
|
*/
|
|
210
|
-
readonly workspace?:
|
|
210
|
+
readonly workspace?: AgentWorkspaceConfig;
|
|
211
211
|
}
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
// - skills : ADD-only (identity skills are the floor)
|
|
19
19
|
//
|
|
20
20
|
// Agent SELECTION (which agent runs) is deliberately NOT part of this overlay:
|
|
21
|
-
// in a workflow that is `agentSlug
|
|
21
|
+
// in a workflow that is `agentSlug` (short form); `agentRef` selects a published Agent
|
|
22
22
|
// workspace SOURCE, not the agent (see plan audit A5). The overlay only SHAPES
|
|
23
23
|
// the already-selected agent.
|
|
24
24
|
// ═══════════════════════════════════════════════════════════════════════════
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
|
|
17
17
|
export * from './lib/workspace-layout';
|
|
18
18
|
export * from './lib/workspace-spec';
|
|
19
|
-
export * from './lib/awp
|
|
19
|
+
export * from './lib/awp';
|
|
20
20
|
export * from './lib/context-json';
|
|
21
21
|
export * from './lib/manifest';
|
|
22
22
|
export * from './lib/deliverable-spec-ref';
|
|
@@ -123,7 +123,7 @@ export type WorkingFileSourceKind = string;
|
|
|
123
123
|
|
|
124
124
|
/**
|
|
125
125
|
* Resolved working-file declaration projected onto the WorkspaceSpec and
|
|
126
|
-
* carried into the session bundle.
|
|
126
|
+
* carried into the session bundle. Agent authors declare the
|
|
127
127
|
* authored shape (with `${input.x}` templating); resolution produces this
|
|
128
128
|
* concrete form with the bind inputs interpolated.
|
|
129
129
|
*
|