@xemahq/kernel-contracts 0.1.0

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

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillLayer = exports.SKILL_SURFACES = exports.SkillSurface = exports.SkillInjectionMode = exports.SkillResourceType = exports.SkillKind = exports.SkillSourceKind = exports.SkillSpace = void 0;
+var SkillSpace;
+(function (SkillSpace) {
+    SkillSpace["System"] = "system";
+    SkillSpace["Biome"] = "biome";
+    SkillSpace["Org"] = "org";
+    SkillSpace["Project"] = "project";
+    SkillSpace["User"] = "user";
+})(SkillSpace || (exports.SkillSpace = SkillSpace = {}));
+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 = {}));
+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["Pinned"] = "pinned";
+    SkillLayer["Context"] = "context";
+})(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":";;;AAgBA,IAAY,UAWX;AAXD,WAAY,UAAU;IAEpB,+BAAiB,CAAA;IAEjB,6BAAe,CAAA;IAEf,yBAAW,CAAA;IAEX,iCAAmB,CAAA;IAEnB,2BAAa,CAAA;AACf,CAAC,EAXW,UAAU,0BAAV,UAAU,QAWrB;AAKD,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;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;AAOX,IAAY,UASX;AATD,WAAY,UAAU;IAEpB,+BAAiB,CAAA;IAEjB,2BAAa,CAAA;IAEb,+BAAiB,CAAA;IAEjB,iCAAmB,CAAA;AACrB,CAAC,EATW,UAAU,0BAAV,UAAU,QASrB"}

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

@@ -0,0 +1,106 @@
+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",
+    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 SkillAssertionVerdict {
+    Pass = "pass",
+    Fail = "fail"
+}
+export declare enum SkillAssertionGradingMethod {
+    Mechanical = "mechanical",
+    LlmJudge = "llm_judge"
+}
+export interface SkillAssertionResult {
+    readonly assertion: string;
+    readonly verdict: SkillAssertionVerdict;
+    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":"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"}

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

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_EVAL_DEFAULT_PASS_RATE_THRESHOLD = exports.SkillAssertionGradingMethod = exports.SkillAssertionVerdict = exports.SkillEvalRunStatus = exports.SkillEvalRunConfig = exports.SkillTriggerExpectation = exports.SkillLifecycleState = exports.SkillGovernanceAction = exports.SkillRiskIndicator = exports.SkillRiskTier = void 0;
+var SkillRiskTier;
+(function (SkillRiskTier) {
+    SkillRiskTier["Low"] = "low";
+    SkillRiskTier["Medium"] = "medium";
+    SkillRiskTier["High"] = "high";
+})(SkillRiskTier || (exports.SkillRiskTier = SkillRiskTier = {}));
+var SkillRiskIndicator;
+(function (SkillRiskIndicator) {
+    SkillRiskIndicator["ScriptResource"] = "script_resource";
+    SkillRiskIndicator["McpToolReference"] = "mcp_tool_reference";
+    SkillRiskIndicator["NetworkCall"] = "network_call";
+    SkillRiskIndicator["PathTraversal"] = "path_traversal";
+    SkillRiskIndicator["HardcodedCredential"] = "hardcoded_credential";
+    SkillRiskIndicator["ShellInvocation"] = "shell_invocation";
+})(SkillRiskIndicator || (exports.SkillRiskIndicator = SkillRiskIndicator = {}));
+var SkillGovernanceAction;
+(function (SkillGovernanceAction) {
+    SkillGovernanceAction["SubmitForReview"] = "submit_for_review";
+    SkillGovernanceAction["Approve"] = "approve";
+    SkillGovernanceAction["Reject"] = "reject";
+    SkillGovernanceAction["Deprecate"] = "deprecate";
+    SkillGovernanceAction["Rollback"] = "rollback";
+})(SkillGovernanceAction || (exports.SkillGovernanceAction = SkillGovernanceAction = {}));
+var SkillLifecycleState;
+(function (SkillLifecycleState) {
+    SkillLifecycleState["Draft"] = "draft";
+    SkillLifecycleState["InReview"] = "in_review";
+    SkillLifecycleState["Approved"] = "approved";
+    SkillLifecycleState["Deprecated"] = "deprecated";
+})(SkillLifecycleState || (exports.SkillLifecycleState = SkillLifecycleState = {}));
+var SkillTriggerExpectation;
+(function (SkillTriggerExpectation) {
+    SkillTriggerExpectation["ShouldTrigger"] = "should_trigger";
+    SkillTriggerExpectation["ShouldNotTrigger"] = "should_not_trigger";
+})(SkillTriggerExpectation || (exports.SkillTriggerExpectation = SkillTriggerExpectation = {}));
+var SkillEvalRunConfig;
+(function (SkillEvalRunConfig) {
+    SkillEvalRunConfig["WithSkill"] = "with_skill";
+    SkillEvalRunConfig["WithoutSkill"] = "without_skill";
+})(SkillEvalRunConfig || (exports.SkillEvalRunConfig = SkillEvalRunConfig = {}));
+var SkillEvalRunStatus;
+(function (SkillEvalRunStatus) {
+    SkillEvalRunStatus["Running"] = "running";
+    SkillEvalRunStatus["Completed"] = "completed";
+    SkillEvalRunStatus["Failed"] = "failed";
+})(SkillEvalRunStatus || (exports.SkillEvalRunStatus = SkillEvalRunStatus = {}));
+var SkillAssertionVerdict;
+(function (SkillAssertionVerdict) {
+    SkillAssertionVerdict["Pass"] = "pass";
+    SkillAssertionVerdict["Fail"] = "fail";
+})(SkillAssertionVerdict || (exports.SkillAssertionVerdict = SkillAssertionVerdict = {}));
+var SkillAssertionGradingMethod;
+(function (SkillAssertionGradingMethod) {
+    SkillAssertionGradingMethod["Mechanical"] = "mechanical";
+    SkillAssertionGradingMethod["LlmJudge"] = "llm_judge";
+})(SkillAssertionGradingMethod || (exports.SkillAssertionGradingMethod = SkillAssertionGradingMethod = {}));
+exports.SKILL_EVAL_DEFAULT_PASS_RATE_THRESHOLD = 0.8;
+//# sourceMappingURL=skill-governance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-governance.js","sourceRoot":"","sources":["../../../src/skill/lib/skill-governance.ts"],"names":[],"mappings":";;;AAoBA,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,8BAAa,CAAA;AACf,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAaD,IAAY,kBAaX;AAbD,WAAY,kBAAkB;IAE5B,wDAAkC,CAAA;IAElC,6DAAuC,CAAA;IAEvC,kDAA4B,CAAA;IAE5B,sDAAgC,CAAA;IAEhC,kEAA4C,CAAA;IAE5C,0DAAoC,CAAA;AACtC,CAAC,EAbW,kBAAkB,kCAAlB,kBAAkB,QAa7B;AAMD,IAAY,qBAMX;AAND,WAAY,qBAAqB;IAC/B,8DAAqC,CAAA;IACrC,4CAAmB,CAAA;IACnB,0CAAiB,CAAA;IACjB,gDAAuB,CAAA;IACvB,8CAAqB,CAAA;AACvB,CAAC,EANW,qBAAqB,qCAArB,qBAAqB,QAMhC;AAOD,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,sCAAe,CAAA;IACf,6CAAsB,CAAA;IACtB,4CAAqB,CAAA;IACrB,gDAAyB,CAAA;AAC3B,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B;AAYD,IAAY,uBAKX;AALD,WAAY,uBAAuB;IAEjC,2DAAgC,CAAA;IAEhC,kEAAuC,CAAA;AACzC,CAAC,EALW,uBAAuB,uCAAvB,uBAAuB,QAKlC;AAuDD,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAE5B,8CAAwB,CAAA;IAExB,oDAA8B,CAAA;AAChC,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B;AAMD,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAE5B,yCAAmB,CAAA;IAEnB,6CAAuB,CAAA;IAEvB,uCAAiB,CAAA;AACnB,CAAC,EAPW,kBAAkB,kCAAlB,kBAAkB,QAO7B;AAKD,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,sCAAa,CAAA;IACb,sCAAa,CAAA;AACf,CAAC,EAHW,qBAAqB,qCAArB,qBAAqB,QAGhC;AAOD,IAAY,2BAKX;AALD,WAAY,2BAA2B;IAErC,wDAAyB,CAAA;IAEzB,qDAAsB,CAAA;AACxB,CAAC,EALW,2BAA2B,2CAA3B,2BAA2B,QAKtC;AAgGY,QAAA,sCAAsC,GAAG,GAAG,CAAC"}

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

@@ -0,0 +1,14 @@
+export interface SkillRepositorySpec {
+    readonly id: string;
+    readonly url: string;
+    readonly ref?: string;
+    readonly rootPath?: string;
+}
+export interface SkillRepositorySyncResult {
+    readonly repositoryId: string;
+    readonly resolvedRef: string;
+    readonly ingestedSkillSlugs: readonly string[];
+    readonly removedSkillSlugs: readonly string[];
+    readonly syncedAt: string;
+}
+//# sourceMappingURL=skill-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-source.d.ts","sourceRoot":"","sources":["../../../src/skill/lib/skill-source.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAKtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAKD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAE/C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

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

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

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

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

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

@@ -0,0 +1,52 @@
+import type { SkillSpace, SkillSourceKind, SkillKind, SkillResourceType, SkillInjectionMode, SkillLayer, SkillSurface } from './skill-enums';
+import type { SkillRiskTier, SkillLifecycleState } from './skill-governance';
+export interface SkillRef {
+    readonly slug: string;
+    readonly version?: string;
+}
+export interface SkillFrontmatter {
+    readonly name: string;
+    readonly description: string;
+    readonly kind?: SkillKind;
+    readonly injectionMode?: SkillInjectionMode;
+    readonly category?: string;
+    readonly tags?: readonly string[];
+    readonly surfaces?: readonly SkillSurface[];
+}
+export interface SkillResource {
+    readonly relPath: string;
+    readonly type: SkillResourceType;
+    readonly sizeBytes?: number;
+}
+export interface SkillManifest {
+    readonly slug: string;
+    readonly name: string;
+    readonly description: string;
+    readonly kind: SkillKind;
+    readonly scope: SkillSpace;
+    readonly sourceKind: SkillSourceKind;
+    readonly injectionMode: SkillInjectionMode;
+    readonly version: string;
+    readonly parentSlug: string | null;
+    readonly lifecycleState: SkillLifecycleState;
+    readonly riskTier: SkillRiskTier;
+    readonly checksum: string;
+    readonly resources: readonly SkillResource[];
+    readonly surfaces: readonly SkillSurface[] | null;
+}
+export interface SkillNode {
+    readonly manifest: SkillManifest;
+    readonly children: readonly SkillNode[];
+}
+export interface Skill {
+    readonly manifest: SkillManifest;
+    readonly skillMarkdown: string;
+}
+export interface ResolvedSkill {
+    readonly slug: string;
+    readonly name: string;
+    readonly description: string;
+    readonly content: string;
+    readonly layer: SkillLayer;
+}
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/skill/lib/skill.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAO7E,MAAM,WAAW,QAAQ;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,MAAM,WAAW,gBAAgB;IAE/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAE5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAuBlC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC7C;AAMD,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD,MAAM,WAAW,aAAa;IAE5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAE3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAM7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAAC;CACnD;AAMD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAMD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAOD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B"}

package/dist/skill/lib/skill.js

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

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

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

package/dist/space/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/space';
+export * from './lib/space-ref-parser';
+export * from './lib/space-traversal';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/space/index.js

@@ -0,0 +1,20 @@
+"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/space"), exports);
+__exportStar(require("./lib/space-ref-parser"), exports);
+__exportStar(require("./lib/space-traversal"), exports);
+//# sourceMappingURL=index.js.map

package/dist/space/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/space/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,yDAAuC;AACvC,wDAAsC"}

package/dist/space/lib/space-ref-parser.d.ts

@@ -0,0 +1,8 @@
+import { type SpaceRef } from './space';
+export declare class SpaceRefParseError extends Error {
+    readonly raw: string;
+    constructor(message: string, raw: string);
+}
+export declare function parseSpaceRef(uri: string): SpaceRef;
+export declare function formatSpaceRef(ref: SpaceRef): string;
+//# sourceMappingURL=space-ref-parser.d.ts.map

package/dist/space/lib/space-ref-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-ref-parser.d.ts","sourceRoot":"","sources":["../../../src/space/lib/space-ref-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAwDnD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBACT,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKzC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAuEnD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CA2DpD"}

package/dist/space/lib/space-ref-parser.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpaceRefParseError = void 0;
+exports.parseSpaceRef = parseSpaceRef;
+exports.formatSpaceRef = formatSpaceRef;
+const space_1 = require("./space");
+const SCHEME = 'xema://';
+const IDENT_REGEX = /^[a-z0-9][a-z0-9_-]*$/;
+const SEGMENT_KEYS = ['org', 'project', 'app', 'session', 'biome', 'user'];
+const SEGMENT_KEY_SET = new Set(SEGMENT_KEYS);
+const KIND_BY_DEEPEST_SEGMENT = {
+    org: space_1.SpaceKind.Org,
+    project: space_1.SpaceKind.Project,
+    app: space_1.SpaceKind.App,
+    session: space_1.SpaceKind.Session,
+    biome: space_1.SpaceKind.Biome,
+    user: space_1.SpaceKind.User,
+};
+const FIELD_OF = {
+    org: 'orgId',
+    project: 'projectId',
+    app: 'appId',
+    session: 'sessionId',
+    biome: 'biomeId',
+    user: 'userId',
+};
+const PARENT_OF = {
+    org: null,
+    project: 'org',
+    app: 'project',
+    session: 'app',
+    biome: 'app',
+    user: null,
+};
+class SpaceRefParseError extends Error {
+    raw;
+    constructor(message, raw) {
+        super(message);
+        this.name = 'SpaceRefParseError';
+        this.raw = raw;
+    }
+}
+exports.SpaceRefParseError = SpaceRefParseError;
+function parseSpaceRef(uri) {
+    if (typeof uri !== 'string' || uri.length === 0) {
+        throw new SpaceRefParseError('SpaceRef URI must be a non-empty string.', String(uri));
+    }
+    if (!uri.startsWith(SCHEME)) {
+        throw new SpaceRefParseError(`SpaceRef URI must start with "${SCHEME}".`, uri);
+    }
+    const body = uri.slice(SCHEME.length);
+    if (body.length === 0) {
+        throw new SpaceRefParseError('SpaceRef URI has empty body after scheme.', uri);
+    }
+    const parts = body.split('/');
+    if (parts.length === 1 && parts[0] === 'system') {
+        return { tier: space_1.SpaceKind.System, path: uri };
+    }
+    if (parts.length % 2 !== 0) {
+        throw new SpaceRefParseError(`SpaceRef URI body must be pairs of <segment>/<id> (got ${parts.length} parts).`, uri);
+    }
+    const segments = {};
+    let lastSegment = null;
+    for (let i = 0; i < parts.length; i += 2) {
+        const key = parts[i];
+        const value = parts[i + 1];
+        if (!SEGMENT_KEY_SET.has(key)) {
+            throw new SpaceRefParseError(`SpaceRef URI has unknown segment key "${key}". Allowed: ${SEGMENT_KEYS.join(', ')}.`, uri);
+        }
+        const typedKey = key;
+        if (segments[typedKey] !== undefined) {
+            throw new SpaceRefParseError(`SpaceRef URI repeats segment "${key}".`, uri);
+        }
+        if (!IDENT_REGEX.test(value)) {
+            throw new SpaceRefParseError(`SpaceRef URI segment "${key}" has invalid id "${value}".`, uri);
+        }
+        const expectedParent = PARENT_OF[typedKey];
+        if (expectedParent !== lastSegment) {
+            throw new SpaceRefParseError(`SpaceRef URI segment "${key}" must follow "${expectedParent ?? '(root)'}", got "${lastSegment ?? '(root)'}".`, uri);
+        }
+        segments[typedKey] = value;
+        lastSegment = typedKey;
+    }
+    if (lastSegment === null) {
+        throw new SpaceRefParseError('SpaceRef URI parsed no segments.', uri);
+    }
+    const tier = KIND_BY_DEEPEST_SEGMENT[lastSegment];
+    const ref = { tier, path: uri };
+    for (const segKey of SEGMENT_KEYS) {
+        const segValue = segments[segKey];
+        if (segValue !== undefined) {
+            const fieldName = FIELD_OF[segKey];
+            ref[fieldName] = segValue;
+        }
+    }
+    return ref;
+}
+function formatSpaceRef(ref) {
+    if (ref.tier === space_1.SpaceKind.System) {
+        return `${SCHEME}system`;
+    }
+    const out = [SCHEME];
+    const append = (key, value) => {
+        if (value === undefined) {
+            throw new SpaceRefParseError(`formatSpaceRef: missing required segment "${key}" for tier "${ref.tier}".`, ref.tier);
+        }
+        if (!IDENT_REGEX.test(value)) {
+            throw new SpaceRefParseError(`formatSpaceRef: segment "${key}" id "${value}" violates grammar.`, ref.tier);
+        }
+        if (out.length > 1)
+            out.push('/');
+        out.push(`${key}/${value}`);
+    };
+    switch (ref.tier) {
+        case space_1.SpaceKind.User:
+            append('user', ref.userId);
+            break;
+        case space_1.SpaceKind.Org:
+            append('org', ref.orgId);
+            break;
+        case space_1.SpaceKind.Project:
+            append('org', ref.orgId);
+            append('project', ref.projectId);
+            break;
+        case space_1.SpaceKind.App:
+            append('org', ref.orgId);
+            append('project', ref.projectId);
+            append('app', ref.appId);
+            break;
+        case space_1.SpaceKind.Session:
+            append('org', ref.orgId);
+            append('project', ref.projectId);
+            append('app', ref.appId);
+            append('session', ref.sessionId);
+            break;
+        case space_1.SpaceKind.Biome:
+            append('org', ref.orgId);
+            append('project', ref.projectId);
+            append('app', ref.appId);
+            append('biome', ref.biomeId);
+            break;
+        default: {
+            const exhaustive = ref.tier;
+            throw new SpaceRefParseError(`formatSpaceRef: unhandled SpaceKind "${String(exhaustive)}".`, String(exhaustive));
+        }
+    }
+    return out.join('');
+}
+//# sourceMappingURL=space-ref-parser.js.map

package/dist/space/lib/space-ref-parser.js.map

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

package/dist/space/lib/space-traversal.d.ts

@@ -0,0 +1,3 @@
+import { type SpaceRef } from './space';
+export declare function walkAncestors(ref: SpaceRef): SpaceRef[];
+//# sourceMappingURL=space-traversal.d.ts.map

package/dist/space/lib/space-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-traversal.d.ts","sourceRoot":"","sources":["../../../src/space/lib/space-traversal.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AASnD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAQvD"}

package/dist/space/lib/space-traversal.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walkAncestors = walkAncestors;
+const space_ref_parser_1 = require("./space-ref-parser");
+const space_1 = require("./space");
+function walkAncestors(ref) {
+    const out = [];
+    let current = ref;
+    while (current !== null) {
+        out.push(current);
+        current = parentOf(current);
+    }
+    return out;
+}
+function parentOf(ref) {
+    switch (ref.tier) {
+        case space_1.SpaceKind.System:
+            return null;
+        case space_1.SpaceKind.User:
+        case space_1.SpaceKind.Org:
+            return { tier: space_1.SpaceKind.System, path: (0, space_ref_parser_1.formatSpaceRef)({ tier: space_1.SpaceKind.System }) };
+        case space_1.SpaceKind.Project: {
+            const parent = { tier: space_1.SpaceKind.Org };
+            if (ref.orgId !== undefined)
+                parent.orgId = ref.orgId;
+            parent.path = (0, space_ref_parser_1.formatSpaceRef)(parent);
+            return parent;
+        }
+        case space_1.SpaceKind.App: {
+            const parent = { tier: space_1.SpaceKind.Project };
+            if (ref.orgId !== undefined)
+                parent.orgId = ref.orgId;
+            if (ref.projectId !== undefined)
+                parent.projectId = ref.projectId;
+            parent.path = (0, space_ref_parser_1.formatSpaceRef)(parent);
+            return parent;
+        }
+        case space_1.SpaceKind.Session:
+        case space_1.SpaceKind.Biome: {
+            const parent = { tier: space_1.SpaceKind.App };
+            if (ref.orgId !== undefined)
+                parent.orgId = ref.orgId;
+            if (ref.projectId !== undefined)
+                parent.projectId = ref.projectId;
+            if (ref.appId !== undefined)
+                parent.appId = ref.appId;
+            parent.path = (0, space_ref_parser_1.formatSpaceRef)(parent);
+            return parent;
+        }
+        default: {
+            const exhaustive = ref.tier;
+            throw new Error(`walkAncestors: unhandled SpaceKind "${String(exhaustive)}".`);
+        }
+    }
+}
+//# sourceMappingURL=space-traversal.js.map

package/dist/space/lib/space-traversal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-traversal.js","sourceRoot":"","sources":["../../../src/space/lib/space-traversal.ts"],"names":[],"mappings":";;AAUA,sCAQC;AAlBD,yDAAoD;AACpD,mCAAmD;AASnD,SAAgB,aAAa,CAAC,GAAa;IACzC,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAoB,GAAG,CAAC;IACnC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,GAAa;IAC7B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,iBAAS,CAAC,MAAM;YACnB,OAAO,IAAI,CAAC;QACd,KAAK,iBAAS,CAAC,IAAI,CAAC;QACpB,KAAK,iBAAS,CAAC,GAAG;YAChB,OAAO,EAAE,IAAI,EAAE,iBAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAA,iCAAc,EAAC,EAAE,IAAI,EAAE,iBAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACtF,KAAK,iBAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACvB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,GAAG,EAAE,CAAC;YACjD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,iBAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,OAAO,EAAE,CAAC;YACrD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAClE,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,iBAAS,CAAC,OAAO,CAAC;QACvB,KAAK,iBAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAAa,EAAE,IAAI,EAAE,iBAAS,CAAC,GAAG,EAAE,CAAC;YACjD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;gBAAE,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAClE,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;YACtD,MAAM,CAAC,IAAI,GAAG,IAAA,iCAAc,EAAC,MAAM,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,GAAG,CAAC,IAAI,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;AACH,CAAC"}