@xemahq/contracts 0.1.0

package/dist/session-launch/lib/invocation-overlay.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvocationOverlaySchema = exports.NativeToolRestrictionSchema = exports.ResourceBindingRefSchema = exports.RevisionPinSchema = exports.InvocationModelIntentSchema = exports.InvocationInstructionSchema = exports.InvocationInstructionModeSchema = exports.InvocationInstructionMode = void 0;
+exports.createInvocationOverlay = createInvocationOverlay;
+exports.serializeInvocationOverlay = serializeInvocationOverlay;
+exports.computeInvocationOverlayHash = computeInvocationOverlayHash;
+exports.mergeInvocationOverlays = mergeInvocationOverlays;
+const zod_1 = require("zod");
+const content_address_1 = require("../../content-address");
+const model_1 = require("../../model");
+const object_1 = require("../../object");
+const BOUNDED_OPAQUE_REF = zod_1.z
+    .string()
+    .min(1)
+    .max(2_048)
+    .regex(content_address_1.OPAQUE_TOKEN_PATTERN, 'reference must be opaque and contain no whitespace or control characters')
+    .refine((value) => !looksLikeSecretMaterial(value), {
+    message: 'reference must not contain credential or secret material',
+});
+const CanonicalJsonValueSchema = zod_1.z.lazy(() => zod_1.z.union([
+    zod_1.z.null(),
+    zod_1.z.boolean(),
+    zod_1.z.number().finite(),
+    zod_1.z.string(),
+    zod_1.z.array(CanonicalJsonValueSchema).readonly(),
+    zod_1.z.record(zod_1.z.string(), CanonicalJsonValueSchema).readonly(),
+]));
+const InvocationInputsSchema = zod_1.z
+    .record(zod_1.z.string().min(1).max(256), CanonicalJsonValueSchema)
+    .superRefine((value, context) => {
+    addForbiddenInvocationStateIssues(value, context);
+})
+    .readonly();
+var InvocationInstructionMode;
+(function (InvocationInstructionMode) {
+    InvocationInstructionMode["Append"] = "append";
+    InvocationInstructionMode["ReplaceOverlay"] = "replace-overlay";
+})(InvocationInstructionMode || (exports.InvocationInstructionMode = InvocationInstructionMode = {}));
+exports.InvocationInstructionModeSchema = zod_1.z.nativeEnum(InvocationInstructionMode);
+exports.InvocationInstructionSchema = zod_1.z
+    .object({
+    mode: exports.InvocationInstructionModeSchema,
+    text: zod_1.z
+        .string()
+        .min(1)
+        .max(100_000)
+        .refine((value) => value.trim().length > 0, 'text must not be blank'),
+})
+    .strict();
+exports.InvocationModelIntentSchema = zod_1.z
+    .object({
+    modelClass: model_1.ModelClassSchema,
+})
+    .strict();
+exports.RevisionPinSchema = zod_1.z
+    .object({
+    resourceId: BOUNDED_OPAQUE_REF,
+    revisionId: BOUNDED_OPAQUE_REF,
+    contentHash: content_address_1.Sha256HexSchema,
+})
+    .strict();
+exports.ResourceBindingRefSchema = zod_1.z
+    .object({
+    ref: (0, object_1.createVersionedXemaObjectRefSchema)(object_1.XemaObjectKind.Resource),
+    contentHash: content_address_1.Sha256HexSchema,
+})
+    .strict();
+exports.NativeToolRestrictionSchema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('allow-only'),
+    nativeToolRefs: zod_1.z.array(BOUNDED_OPAQUE_REF).readonly(),
+})
+    .strict()
+    .superRefine((value, context) => {
+    addStrictlySortedIssues(value.nativeToolRefs, (entry) => entry, context, ['nativeToolRefs'], 'nativeToolRefs');
+});
+exports.InvocationOverlaySchema = zod_1.z
+    .object({
+    schemaVersion: zod_1.z.literal(2),
+    inputs: InvocationInputsSchema,
+    instruction: exports.InvocationInstructionSchema.optional(),
+    modelIntent: exports.InvocationModelIntentSchema.optional(),
+    skillRevisionRefs: zod_1.z.array(exports.RevisionPinSchema).readonly().optional(),
+    capabilityRefs: zod_1.z.array(BOUNDED_OPAQUE_REF).readonly().optional(),
+    resourceBindings: zod_1.z
+        .array(exports.ResourceBindingRefSchema)
+        .max(128)
+        .readonly()
+        .optional(),
+    nativeToolRestriction: exports.NativeToolRestrictionSchema.optional(),
+    outputRouteRef: BOUNDED_OPAQUE_REF.optional(),
+})
+    .strict()
+    .superRefine((value, context) => {
+    addExplicitUndefinedIssues(value, [
+        'instruction',
+        'modelIntent',
+        'skillRevisionRefs',
+        'capabilityRefs',
+        'resourceBindings',
+        'nativeToolRestriction',
+        'outputRouteRef',
+    ], context);
+    if (value.skillRevisionRefs !== undefined) {
+        addStrictlySortedIssues(value.skillRevisionRefs, (entry) => entry.resourceId, context, ['skillRevisionRefs'], 'skillRevisionRefs');
+    }
+    if (value.capabilityRefs !== undefined) {
+        addStrictlySortedIssues(value.capabilityRefs, (entry) => entry, context, ['capabilityRefs'], 'capabilityRefs');
+    }
+    if (value.resourceBindings !== undefined) {
+        addStrictlySortedIssues(value.resourceBindings, resourceBindingKey, context, ['resourceBindings'], 'resourceBindings');
+    }
+});
+function createInvocationOverlay(input) {
+    (0, content_address_1.canonicalJsonStringify)(input);
+    return (0, content_address_1.deepFreezeCanonicalJson)(exports.InvocationOverlaySchema.parse(input));
+}
+function serializeInvocationOverlay(input) {
+    return (0, content_address_1.canonicalJsonStringify)(createInvocationOverlay(input));
+}
+async function computeInvocationOverlayHash(input) {
+    return (0, content_address_1.canonicalContentHash)({
+        contract: 'xema-invocation-overlay-v2',
+        overlay: createInvocationOverlay(input),
+    });
+}
+function mergeInvocationOverlays(baseInput, oneOffInput) {
+    const base = createInvocationOverlay(baseInput);
+    const oneOff = createInvocationOverlay(oneOffInput);
+    const instruction = mergeInstructions(base.instruction, oneOff.instruction);
+    const nativeToolRestriction = mergeNativeToolRestrictions(base.nativeToolRestriction, oneOff.nativeToolRestriction);
+    return createInvocationOverlay({
+        schemaVersion: 2,
+        inputs: { ...base.inputs, ...oneOff.inputs },
+        ...(instruction === undefined ? {} : { instruction }),
+        ...inheritedOptional('modelIntent', base, oneOff),
+        ...inheritedOptional('skillRevisionRefs', base, oneOff),
+        ...inheritedOptional('capabilityRefs', base, oneOff),
+        ...inheritedOptional('resourceBindings', base, oneOff),
+        ...(nativeToolRestriction === undefined ? {} : { nativeToolRestriction }),
+        ...inheritedOptional('outputRouteRef', base, oneOff),
+    });
+}
+function inheritedOptional(key, base, oneOff) {
+    const value = oneOff[key] === undefined ? base[key] : oneOff[key];
+    return value === undefined
+        ? {}
+        : { [key]: value };
+}
+function addExplicitUndefinedIssues(value, optionalKeys, context) {
+    for (const key of optionalKeys) {
+        if (Object.hasOwn(value, key) && value[key] === undefined) {
+            context.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: [key],
+                message: `${key} must be omitted rather than set to undefined.`,
+            });
+        }
+    }
+}
+function mergeInstructions(base, oneOff) {
+    if (oneOff === undefined) {
+        return base;
+    }
+    if (base === undefined ||
+        oneOff.mode === InvocationInstructionMode.ReplaceOverlay) {
+        return oneOff;
+    }
+    return {
+        mode: base.mode,
+        text: `${base.text}\n\n${oneOff.text}`,
+    };
+}
+function mergeNativeToolRestrictions(base, oneOff) {
+    if (oneOff === undefined) {
+        return base;
+    }
+    if (base === undefined) {
+        return oneOff;
+    }
+    const oneOffRefs = new Set(oneOff.nativeToolRefs);
+    return {
+        kind: 'allow-only',
+        nativeToolRefs: base.nativeToolRefs.filter((ref) => oneOffRefs.has(ref)),
+    };
+}
+function resourceBindingKey(entry) {
+    return entry.ref;
+}
+function addStrictlySortedIssues(values, keyOf, context, path, label) {
+    for (let index = 1; index < values.length; index += 1) {
+        const previous = values[index - 1];
+        const current = values[index];
+        if (previous === undefined || current === undefined) {
+            continue;
+        }
+        const previousKey = keyOf(previous);
+        const currentKey = keyOf(current);
+        if (currentKey <= previousKey) {
+            context.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: [...path, index],
+                message: currentKey === previousKey
+                    ? `${label} must not contain duplicates.`
+                    : `${label} must be sorted in ascending canonical order.`,
+            });
+        }
+    }
+}
+const FORBIDDEN_FIELD_PATTERN = /(?:api.?key|authorization|cookie|credential|password|private.?key|secret|token|snapshot|prepared.*template|runtime.*template|filesystem|file.?path|mount.?path|absolute.?path|workspace.?path|checkout.?path|working.?directory|cwd)/iu;
+function addForbiddenInvocationStateIssues(value, context, path = []) {
+    if (typeof value === 'string') {
+        if (looksLikeSecretMaterial(value)) {
+            context.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: [...path],
+                message: 'Invocation inputs must not contain credential or secret material.',
+            });
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach((entry, index) => addForbiddenInvocationStateIssues(entry, context, [...path, index]));
+        return;
+    }
+    if (value === null || typeof value !== 'object') {
+        return;
+    }
+    for (const [key, entry] of Object.entries(value)) {
+        if (FORBIDDEN_FIELD_PATTERN.test(key)) {
+            context.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                path: [...path, key],
+                message: 'Invocation inputs must not contain filesystem, template, snapshot, credential, or secret fields.',
+            });
+        }
+        addForbiddenInvocationStateIssues(entry, context, [...path, key]);
+    }
+}
+const SECRET_VALUE_PATTERNS = [
+    /-----BEGIN (?:[A-Z ]+ )?PRIVATE KEY-----/u,
+    /^(?:Bearer|Basic)\s+\S+/iu,
+    /^(?:sk-(?:live|test|proj)-|gh[pousr]_|github_pat_|xox[baprs]-)/u,
+    /^AKIA[A-Z0-9]{16}$/u,
+    /^AIza[0-9A-Za-z_-]{35}$/u,
+    /^[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}$/u,
+    /^[a-z][a-z0-9+.-]*:\/\/[^/@:\s]+:[^/@\s]+@/iu,
+];
+function looksLikeSecretMaterial(value) {
+    return SECRET_VALUE_PATTERNS.some((pattern) => pattern.test(value));
+}
+//# sourceMappingURL=invocation-overlay.js.map

package/dist/session-launch/lib/invocation-overlay.js.map

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

package/dist/session-launch/lib/standing-session.d.ts

@@ -0,0 +1,4 @@
+export interface StandingSessionRef {
+    readonly pinKey: string;
+}
+//# sourceMappingURL=standing-session.d.ts.map

package/dist/session-launch/lib/standing-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standing-session.d.ts","sourceRoot":"","sources":["../../../src/session-launch/lib/standing-session.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/session-launch/lib/standing-session.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=standing-session.js.map

package/dist/session-launch/lib/standing-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standing-session.js","sourceRoot":"","sources":["../../../src/session-launch/lib/standing-session.ts"],"names":[],"mappings":""}

package/dist/session-launch/lib/workspace-action.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { type WorkspaceBackingRequest } from './workspace-backing';
+export type WorkspaceAction = {
+    readonly action: 'create';
+    readonly slug: string;
+    readonly displayName: string;
+    readonly backing: WorkspaceBackingRequest;
+} | {
+    readonly action: 'attach';
+    readonly workspaceId: string;
+};
+export declare const WorkspaceActionSchema: z.ZodType<WorkspaceAction>;
+//# sourceMappingURL=workspace-action.d.ts.map

package/dist/session-launch/lib/workspace-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-action.d.ts","sourceRoot":"","sources":["../../../src/session-launch/lib/workspace-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C,GACD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAgBzD,CAAC"}

package/dist/session-launch/lib/workspace-action.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceActionSchema = void 0;
+const zod_1 = require("zod");
+const workspace_backing_1 = require("./workspace-backing");
+exports.WorkspaceActionSchema = zod_1.z.discriminatedUnion('action', [
+    zod_1.z
+        .object({
+        action: zod_1.z.literal('create'),
+        slug: zod_1.z.string().min(1).max(256),
+        displayName: zod_1.z.string().min(1).max(512),
+        backing: workspace_backing_1.WorkspaceBackingRequestSchema,
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        action: zod_1.z.literal('attach'),
+        workspaceId: zod_1.z.string().min(1).max(2_048),
+    })
+        .strict(),
+]);
+//# sourceMappingURL=workspace-action.js.map

package/dist/session-launch/lib/workspace-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-action.js","sourceRoot":"","sources":["../../../src/session-launch/lib/workspace-action.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2DAG6B;AAYhB,QAAA,qBAAqB,GAChC,OAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC7B,OAAC;SACE,MAAM,CAAC;QACN,MAAM,EAAE,OAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC3B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QAChC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,OAAO,EAAE,iDAA6B;KACvC,CAAC;SACD,MAAM,EAAE;IACX,OAAC;SACE,MAAM,CAAC;QACN,MAAM,EAAE,OAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC3B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;KAC1C,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC"}

package/dist/session-launch/lib/workspace-backing.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare enum WorkspaceBackingKind {
+    None = "none",
+    DurableStorage = "durable-storage"
+}
+export declare const WorkspaceBackingKindSchema: z.ZodEnum<typeof WorkspaceBackingKind>;
+export interface WorkspaceBackingRequest {
+    readonly kind: WorkspaceBackingKind;
+}
+export declare const WorkspaceBackingRequestSchema: z.ZodType<WorkspaceBackingRequest>;
+export interface WorkspaceWithoutBacking {
+    readonly kind: WorkspaceBackingKind.None;
+}
+export interface DurableWorkspaceBacking {
+    readonly kind: WorkspaceBackingKind.DurableStorage;
+    readonly storageRef: string;
+}
+export type WorkspaceBacking = WorkspaceWithoutBacking | DurableWorkspaceBacking;
+export declare const WorkspaceBackingSchema: z.ZodType<WorkspaceBacking>;
+//# sourceMappingURL=workspace-backing.d.ts.map

package/dist/session-launch/lib/workspace-backing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-backing.d.ts","sourceRoot":"","sources":["../../../src/session-launch/lib/workspace-backing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,cAAc,oBAAoB;CACnC;AAED,eAAO,MAAM,0BAA0B,wCAAqC,CAAC;AAO7E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAED,eAAO,MAAM,6BAA6B,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CACpB,CAAC;AAE1D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,cAAc,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,gBAAgB,GACxB,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAS3D,CAAC"}

package/dist/session-launch/lib/workspace-backing.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkspaceBackingSchema = exports.WorkspaceBackingRequestSchema = exports.WorkspaceBackingKindSchema = exports.WorkspaceBackingKind = void 0;
+const zod_1 = require("zod");
+const content_address_1 = require("../../content-address");
+const OPAQUE_ID = zod_1.z
+    .string()
+    .min(1)
+    .max(2_048)
+    .regex(content_address_1.OPAQUE_TOKEN_PATTERN, 'identifier must be opaque and contain no whitespace or control characters');
+var WorkspaceBackingKind;
+(function (WorkspaceBackingKind) {
+    WorkspaceBackingKind["None"] = "none";
+    WorkspaceBackingKind["DurableStorage"] = "durable-storage";
+})(WorkspaceBackingKind || (exports.WorkspaceBackingKind = WorkspaceBackingKind = {}));
+exports.WorkspaceBackingKindSchema = zod_1.z.nativeEnum(WorkspaceBackingKind);
+exports.WorkspaceBackingRequestSchema = zod_1.z.object({ kind: exports.WorkspaceBackingKindSchema }).strict();
+exports.WorkspaceBackingSchema = zod_1.z.discriminatedUnion('kind', [
+    zod_1.z.object({ kind: zod_1.z.literal(WorkspaceBackingKind.None) }).strict(),
+    zod_1.z
+        .object({
+        kind: zod_1.z.literal(WorkspaceBackingKind.DurableStorage),
+        storageRef: OPAQUE_ID,
+    })
+        .strict(),
+]);
+//# sourceMappingURL=workspace-backing.js.map

package/dist/session-launch/lib/workspace-backing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-backing.js","sourceRoot":"","sources":["../../../src/session-launch/lib/workspace-backing.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2DAA6D;AAE7D,MAAM,SAAS,GAAG,OAAC;KAChB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,KAAK,CAAC;KACV,KAAK,CACJ,sCAAoB,EACpB,2EAA2E,CAC5E,CAAC;AAEJ,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,qCAAa,CAAA;IACb,0DAAkC,CAAA;AACpC,CAAC,EAHW,oBAAoB,oCAApB,oBAAoB,QAG/B;AAEY,QAAA,0BAA0B,GAAG,OAAC,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAWhE,QAAA,6BAA6B,GACxC,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,kCAA0B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAe7C,QAAA,sBAAsB,GACjC,OAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3B,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACjE,OAAC;SACE,MAAM,CAAC;QACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC;QACpD,UAAU,EAAE,SAAS;KACtB,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC"}

package/dist/skill/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/skill-enums';
+export * from './lib/skill-governance';
+export * from './lib/skill-source';
+export * from './lib/system-skill-baseline';
+export * from './lib/skill';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAWA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC"}

package/dist/skill/index.js

@@ -0,0 +1,22 @@
+"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/skill-enums"), exports);
+__exportStar(require("./lib/skill-governance"), exports);
+__exportStar(require("./lib/skill-source"), exports);
+__exportStar(require("./lib/system-skill-baseline"), exports);
+__exportStar(require("./lib/skill"), exports);
+//# sourceMappingURL=index.js.map

package/dist/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAWA,oDAAkC;AAClC,yDAAuC;AACvC,qDAAmC;AACnC,8DAA4C;AAC5C,8CAA4B"}

package/dist/skill/lib/skill-enums.d.ts

@@ -0,0 +1,36 @@
+import { type SpaceKindSubset } from '../../space';
+export declare const SKILL_SPACE_KINDS: SpaceKindSubset;
+export declare enum SkillSourceKind {
+    System = "system",
+    Biome = "biome",
+    Authored = "authored",
+    GitRepo = "git_repo"
+}
+export declare enum SkillKind {
+    Procedural = "procedural",
+    Deliverable = "deliverable",
+    System = "system"
+}
+export declare function isDerivedSkillKind(kind: SkillKind | string): boolean;
+export declare function derivedSkillKindSource(kind: SkillKind): string;
+export declare enum SkillResourceType {
+    Reference = "reference",
+    Script = "script",
+    Asset = "asset",
+    Template = "template",
+    SubSkill = "sub_skill"
+}
+export declare enum SkillInjectionMode {
+    Always = "always",
+    ContextDependent = "context_dependent"
+}
+export declare enum SkillSurface {
+    Workflow = "workflow",
+    AgentSession = "agent-session"
+}
+export declare const SKILL_SURFACES: readonly SkillSurface[];
+export declare enum SkillLayer {
+    System = "system",
+    Base = "base"
+}
+//# sourceMappingURL=skill-enums.d.ts.map

package/dist/skill/lib/skill-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-enums.d.ts","sourceRoot":"","sources":["../../../src/skill/lib/skill-enums.ts"],"names":[],"mappings":"AAYA,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAkB/E,eAAO,MAAM,iBAAiB,EAAE,eAM/B,CAAC;AAKF,oBAAY,eAAe;IAMzB,MAAM,WAAW;IAEjB,KAAK,UAAU;IAEf,QAAQ,aAAa;IAErB,OAAO,aAAa;CACrB;AAKD,oBAAY,SAAS;IAEnB,UAAU,eAAe;IAEzB,WAAW,gBAAgB;IAE3B,MAAM,WAAW;CAClB;AA8BD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAEpE;AAMD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAO9D;AAMD,oBAAY,iBAAiB;IAE3B,SAAS,cAAc;IAEvB,MAAM,WAAW;IAEjB,KAAK,UAAU;IAEf,QAAQ,aAAa;IAErB,QAAQ,cAAc;CACvB;AAOD,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,gBAAgB,sBAAsB;CACvC;AAeD,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,YAAY,kBAAkB;CAC/B;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAGxC,CAAC;AAUX,oBAAY,UAAU;IAEpB,MAAM,WAAW;IAEjB,IAAI,SAAS;CACd"}

package/dist/skill/lib/skill-enums.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillLayer = exports.SKILL_SURFACES = exports.SkillSurface = exports.SkillInjectionMode = exports.SkillResourceType = exports.SkillKind = exports.SkillSourceKind = exports.SKILL_SPACE_KINDS = void 0;
+exports.isDerivedSkillKind = isDerivedSkillKind;
+exports.derivedSkillKindSource = derivedSkillKindSource;
+const space_1 = require("../../space");
+exports.SKILL_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 SkillSourceKind;
+(function (SkillSourceKind) {
+    SkillSourceKind["System"] = "system";
+    SkillSourceKind["Biome"] = "biome";
+    SkillSourceKind["Authored"] = "authored";
+    SkillSourceKind["GitRepo"] = "git_repo";
+})(SkillSourceKind || (exports.SkillSourceKind = SkillSourceKind = {}));
+var SkillKind;
+(function (SkillKind) {
+    SkillKind["Procedural"] = "procedural";
+    SkillKind["Deliverable"] = "deliverable";
+    SkillKind["System"] = "system";
+})(SkillKind || (exports.SkillKind = SkillKind = {}));
+const DERIVED_SKILL_KINDS = Object.freeze([
+    SkillKind.Deliverable,
+]);
+function isDerivedSkillKind(kind) {
+    return DERIVED_SKILL_KINDS.includes(kind);
+}
+function derivedSkillKindSource(kind) {
+    switch (kind) {
+        case SkillKind.Deliverable:
+            return 'the deliverable spec it projects, in deliverable-specs-api';
+        default:
+            return 'its owning projection path';
+    }
+}
+var SkillResourceType;
+(function (SkillResourceType) {
+    SkillResourceType["Reference"] = "reference";
+    SkillResourceType["Script"] = "script";
+    SkillResourceType["Asset"] = "asset";
+    SkillResourceType["Template"] = "template";
+    SkillResourceType["SubSkill"] = "sub_skill";
+})(SkillResourceType || (exports.SkillResourceType = SkillResourceType = {}));
+var SkillInjectionMode;
+(function (SkillInjectionMode) {
+    SkillInjectionMode["Always"] = "always";
+    SkillInjectionMode["ContextDependent"] = "context_dependent";
+})(SkillInjectionMode || (exports.SkillInjectionMode = SkillInjectionMode = {}));
+var SkillSurface;
+(function (SkillSurface) {
+    SkillSurface["Workflow"] = "workflow";
+    SkillSurface["AgentSession"] = "agent-session";
+})(SkillSurface || (exports.SkillSurface = SkillSurface = {}));
+exports.SKILL_SURFACES = [
+    SkillSurface.Workflow,
+    SkillSurface.AgentSession,
+];
+var SkillLayer;
+(function (SkillLayer) {
+    SkillLayer["System"] = "system";
+    SkillLayer["Base"] = "base";
+})(SkillLayer || (exports.SkillLayer = SkillLayer = {}));
+//# sourceMappingURL=skill-enums.js.map

package/dist/skill/lib/skill-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-enums.js","sourceRoot":"","sources":["../../../src/skill/lib/skill-enums.ts"],"names":[],"mappings":";;;AAgGA,gDAEC;AAMD,wDAOC;AAnGD,uCAA+E;AAkBlE,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;AAKF,IAAY,eAaX;AAbD,WAAY,eAAe;IAMzB,oCAAiB,CAAA;IAEjB,kCAAe,CAAA;IAEf,wCAAqB,CAAA;IAErB,uCAAoB,CAAA;AACtB,CAAC,EAbW,eAAe,+BAAf,eAAe,QAa1B;AAKD,IAAY,SAOX;AAPD,WAAY,SAAS;IAEnB,sCAAyB,CAAA;IAEzB,wCAA2B,CAAA;IAE3B,8BAAiB,CAAA;AACnB,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB;AAiBD,MAAM,mBAAmB,GAAyB,MAAM,CAAC,MAAM,CAAC;IAC9D,SAAS,CAAC,WAAW;CACtB,CAAC,CAAC;AAWH,SAAgB,kBAAkB,CAAC,IAAwB;IACzD,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAMD,SAAgB,sBAAsB,CAAC,IAAe;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS,CAAC,WAAW;YACxB,OAAO,4DAA4D,CAAC;QACtE;YACE,OAAO,4BAA4B,CAAC;IACxC,CAAC;AACH,CAAC;AAMD,IAAY,iBAWX;AAXD,WAAY,iBAAiB;IAE3B,4CAAuB,CAAA;IAEvB,sCAAiB,CAAA;IAEjB,oCAAe,CAAA;IAEf,0CAAqB,CAAA;IAErB,2CAAsB,CAAA;AACxB,CAAC,EAXW,iBAAiB,iCAAjB,iBAAiB,QAW5B;AAOD,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,4DAAsC,CAAA;AACxC,CAAC,EAHW,kBAAkB,kCAAlB,kBAAkB,QAG7B;AAeD,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,8CAA8B,CAAA;AAChC,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AAEY,QAAA,cAAc,GAA4B;IACrD,YAAY,CAAC,QAAQ;IACrB,YAAY,CAAC,YAAY;CACjB,CAAC;AAUX,IAAY,UAKX;AALD,WAAY,UAAU;IAEpB,+BAAiB,CAAA;IAEjB,2BAAa,CAAA;AACf,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB"}

package/dist/skill/lib/skill-governance.d.ts

@@ -0,0 +1,104 @@
+import { EvaluationVerdict } from '../../authored-resource';
+export declare enum SkillRiskTier {
+    Low = "low",
+    Medium = "medium",
+    High = "high"
+}
+export declare enum SkillRiskIndicator {
+    ScriptResource = "script_resource",
+    McpToolReference = "mcp_tool_reference",
+    NetworkCall = "network_call",
+    PathTraversal = "path_traversal",
+    HardcodedCredential = "hardcoded_credential",
+    ShellInvocation = "shell_invocation"
+}
+export declare enum SkillGovernanceAction {
+    SubmitForReview = "submit_for_review",
+    Approve = "approve",
+    Reject = "reject",
+    Deprecate = "deprecate",
+    RestoreToDraft = "restore_to_draft",
+    Rollback = "rollback"
+}
+export declare enum SkillLifecycleState {
+    Draft = "draft",
+    InReview = "in_review",
+    Approved = "approved",
+    Deprecated = "deprecated"
+}
+export declare enum SkillTriggerExpectation {
+    ShouldTrigger = "should_trigger",
+    ShouldNotTrigger = "should_not_trigger"
+}
+export interface SkillEvalCase {
+    readonly id: string;
+    readonly prompt: string;
+    readonly expectedOutput: string;
+    readonly assertions: readonly string[];
+    readonly triggerExpectation: SkillTriggerExpectation;
+    readonly files?: readonly SkillEvalCaseFile[];
+}
+export interface SkillEvalCaseFile {
+    readonly path: string;
+    readonly content: string;
+}
+export interface SkillEvalSuite {
+    readonly skillSlug: string;
+    readonly cases: readonly SkillEvalCase[];
+}
+export declare enum SkillEvalRunConfig {
+    WithSkill = "with_skill",
+    WithoutSkill = "without_skill"
+}
+export declare enum SkillEvalRunStatus {
+    Running = "running",
+    Completed = "completed",
+    Failed = "failed"
+}
+export declare enum SkillAssertionGradingMethod {
+    Mechanical = "mechanical",
+    LlmJudge = "llm_judge"
+}
+export interface SkillAssertionResult {
+    readonly assertion: string;
+    readonly verdict: EvaluationVerdict;
+    readonly method: SkillAssertionGradingMethod;
+    readonly evidence: string;
+}
+export interface SkillCaseGradingSummary {
+    readonly passed: number;
+    readonly failed: number;
+    readonly total: number;
+    readonly passRate: number;
+}
+export interface SkillEvalTiming {
+    readonly totalTokens: number;
+    readonly durationMs: number;
+}
+export interface SkillEvalCaseConfigResult {
+    readonly caseId: string;
+    readonly config: SkillEvalRunConfig;
+    readonly output: string;
+    readonly skillTriggered: boolean;
+    readonly timing: SkillEvalTiming;
+    readonly assertionResults: readonly SkillAssertionResult[];
+    readonly grading: SkillCaseGradingSummary;
+    readonly triggeringCorrect: boolean;
+}
+export interface SkillEvalConfigBenchmark {
+    readonly config: SkillEvalRunConfig;
+    readonly passRate: number;
+    readonly triggeringAccuracy: number;
+    readonly totalTokens: number;
+    readonly totalDurationMs: number;
+}
+export interface SkillEvalBenchmark {
+    readonly withSkill: SkillEvalConfigBenchmark;
+    readonly withoutSkill: SkillEvalConfigBenchmark;
+    readonly passRateDelta: number;
+    readonly triggeringAccuracyDelta: number;
+    readonly totalTokensDelta: number;
+    readonly totalDurationMsDelta: number;
+}
+export declare const SKILL_EVAL_DEFAULT_PASS_RATE_THRESHOLD = 0.8;
+//# sourceMappingURL=skill-governance.d.ts.map

package/dist/skill/lib/skill-governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-governance.d.ts","sourceRoot":"","sources":["../../../src/skill/lib/skill-governance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAoB5D,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAaD,oBAAY,kBAAkB;IAE5B,cAAc,oBAAoB;IAElC,gBAAgB,uBAAuB;IAEvC,WAAW,iBAAiB;IAE5B,aAAa,mBAAmB;IAEhC,mBAAmB,yBAAyB;IAE5C,eAAe,qBAAqB;CACrC;AAyBD,oBAAY,qBAAqB;IAC/B,eAAe,sBAAsB;IACrC,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,cAAc,qBAAqB;IACnC,QAAQ,aAAa;CACtB;AAOD,oBAAY,mBAAmB;IAC7B,KAAK,UAAU;IACf,QAAQ,cAAc;IACtB,QAAQ,aAAa;IACrB,UAAU,eAAe;CAC1B;AAYD,oBAAY,uBAAuB;IAEjC,aAAa,mBAAmB;IAEhC,gBAAgB,uBAAuB;CACxC;AAOD,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAMhC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAKvC,QAAQ,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;IAKrD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C;AAGD,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAQD,oBAAY,kBAAkB;IAE5B,SAAS,eAAe;IAExB,YAAY,kBAAkB;CAC/B;AAMD,oBAAY,kBAAkB;IAE5B,OAAO,YAAY;IAEnB,SAAS,cAAc;IAEvB,MAAM,WAAW;CAClB;AASD,oBAAY,2BAA2B;IAErC,UAAU,eAAe;IAEzB,QAAQ,cAAc;CACvB;AAGD,MAAM,WAAW,oBAAoB;IAEnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAK7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAGD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAGD,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAOD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAEpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAM1C,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAKD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAEpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AASD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;IAEhD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IAEzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAQD,eAAO,MAAM,sCAAsC,MAAM,CAAC"}