@nexus-cortex/types 4.53.0 → 4.54.1

package/dist/artifacts.d.ts

@@ -0,0 +1,57 @@
+/**
+ * ArtifactManifest — canon's SECOND canonical record kind (beside Message).
+ *
+ * Capability artifacts (skills, agents, MCP configs, plugins) and the intent
+ * layer (projects, plans) are versioned document/config BUNDLES, not temporal
+ * event streams — they deliberately do NOT use the Message schema
+ * (CANON_CROSS_HARNESS_PLAN.md §27p). A manifest records identity, version,
+ * blob-addressed content, provenance, and per-harness compatibility; the
+ * artifact bytes live in the store's top-level taxonomy dirs and are
+ * translated between harnesses by per-kind LAYOUT adapters (skill-dir ↔
+ * skill-dir, agent-frontmatter ↔ agent-frontmatter) — never by the gateway
+ * Message conversion.
+ *
+ * plans/projects carry a thin `state` field (doc-snapshot + state — fork 1;
+ * NOT a full event log).
+ */
+export type ArtifactKind = 'skill' | 'agent' | 'mcp' | 'plugin' | 'project' | 'plan';
+export interface ArtifactProvenance {
+    /** Originating harness or source label (claude-code, nexus-cortex, agents-dir, workspace). */
+    harness: string;
+    /** Absolute or store-relative path of the native artifact root captured from. */
+    native: string;
+    /** git blob SHA (12 hex) of the primary content file — content-stable version anchor. */
+    ref: string;
+}
+export interface ArtifactContentEntry {
+    /** Artifact-relative file path. */
+    path: string;
+    /** git blob SHA (12 hex) of the file content (sha1 of "blob <len>\0" + bytes). */
+    ref: string;
+    bytes: number;
+}
+export interface ArtifactManifest {
+    /** Record-kind discriminator vs canon Message records. */
+    recordKind: 'artifact-manifest';
+    kind: ArtifactKind;
+    /** Stable slug (skill/agent name, config id, project label). */
+    id: string;
+    /** Content-derived version = the primary file's blob ref (changes iff content changes). */
+    version: string;
+    name?: string;
+    description?: string;
+    /** ISO capture time (when this manifest snapshot was taken). */
+    timestamp: string;
+    /** Artifact-relative path of the defining file (SKILL.md, <agent>.md, config json). */
+    primary: string;
+    /** Blob-addressed content listing (bytes live under the store taxonomy dir). */
+    content: ArtifactContentEntry[];
+    provenance: ArtifactProvenance;
+    /** Per-harness compatibility, when known. */
+    harnessCompat?: Record<string, 'supported' | 'degraded' | 'absent'>;
+    /** Per-kind layout-adapter hints (target paths per harness, transform notes). */
+    projectionRules?: Record<string, unknown>;
+    /** plans/projects only: thin task/status state — doc-snapshot + state, never an event log. */
+    state?: Record<string, unknown>;
+}
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,kBAAkB;IACjC,8FAA8F;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAC;IACpE,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

package/dist/artifacts.js

@@ -0,0 +1,18 @@
+/**
+ * ArtifactManifest — canon's SECOND canonical record kind (beside Message).
+ *
+ * Capability artifacts (skills, agents, MCP configs, plugins) and the intent
+ * layer (projects, plans) are versioned document/config BUNDLES, not temporal
+ * event streams — they deliberately do NOT use the Message schema
+ * (CANON_CROSS_HARNESS_PLAN.md §27p). A manifest records identity, version,
+ * blob-addressed content, provenance, and per-harness compatibility; the
+ * artifact bytes live in the store's top-level taxonomy dirs and are
+ * translated between harnesses by per-kind LAYOUT adapters (skill-dir ↔
+ * skill-dir, agent-frontmatter ↔ agent-frontmatter) — never by the gateway
+ * Message conversion.
+ *
+ * plans/projects carry a thin `state` field (doc-snapshot + state — fork 1;
+ * NOT a full event log).
+ */
+export {};
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

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

package/dist/index.d.ts

@@ -14,6 +14,7 @@
  */
 export * from './tools';
 export * from './messages';
+export * from './artifacts';
 export * from './session';
 export * from './models';
 export * from './adapters';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -16,6 +16,7 @@
 export * from './tools';
 // Export all message-related types
 export * from './messages';
+export * from './artifacts';
 // Export all session-related types
 export * from './session';
 // Export all model-related types

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,gCAAgC;AAChC,cAAc,SAAS,CAAC;AAExB,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAE3B,mCAAmC;AACnC,cAAc,WAAW,CAAC;AAE1B,iCAAiC;AACjC,cAAc,UAAU,CAAC;AAEzB,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAE3B,oCAAoC;AACpC,cAAc,YAAY,CAAC;AAE3B,mCAAmC;AACnC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,gCAAgC;AAChC,cAAc,SAAS,CAAC;AAExB,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAE5B,mCAAmC;AACnC,cAAc,WAAW,CAAC;AAE1B,iCAAiC;AACjC,cAAc,UAAU,CAAC;AAEzB,mCAAmC;AACnC,cAAc,YAAY,CAAC;AAE3B,oCAAoC;AACpC,cAAc,YAAY,CAAC;AAE3B,mCAAmC;AACnC,cAAc,cAAc,CAAC"}

package/dist/messages.d.ts

@@ -72,5 +72,28 @@ export interface CanonicalMessage {
         /** Additional metadata */
         [key: string]: unknown;
     };
+    /**
+     * J-space state channel (JSPACE_STATE_CHANNEL_PLAN.md S1) — the agent's
+     * per-turn "state of mind" in canonical cluster space, tied to the
+     * canonical history. Optional and non-breaking by construction. Assistant
+     * turns only. Inline `summary` keeps the store light; full per-token
+     * trajectories ride the blob tier via `trajectoryRef` (R2 / git-LFS,
+     * encrypted-at-rest for repo-backed canon). State trails are partial model
+     * internals — P5-style gate before ANY public exposure.
+     */
+    jspaceState?: JSpaceState;
+}
+/** Per-turn j-space state annotation (see CanonicalMessage.jspaceState). */
+export interface JSpaceState {
+    /** Model + lens-fit version (fit-once-cache identity). */
+    lensId: string;
+    /** Cluster-taxonomy version — a new basis is a new league table (D20). */
+    basisVersion: string;
+    /** Per-turn cluster activation vector — small, inline. */
+    summary: number[];
+    /** Blob ref (R2 / git-LFS) for the full per-token trajectory. */
+    trajectoryRef?: string;
+    /** Chaperone cross-checks, when present. */
+    agreement?: Record<string, unknown>;
 }
 //# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAE/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE;QACR,iBAAiB;QACjB,SAAS,EAAE,MAAM,CAAC;QAElB,sCAAsC;QACtC,cAAc,EAAE,MAAM,CAAC;QAEvB,kCAAkC;QAClC,UAAU,EAAE,MAAM,CAAC;QAEnB,4CAA4C;QAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,qCAAqC;QACrC,WAAW,CAAC,EAAE,OAAO,CAAC;QAEtB,qCAAqC;QACrC,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAGF,mBAAmB;IACnB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IAEtC,mBAAmB;IACnB,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,UAAU,GACtD,kBAAkB,GAAG,cAAc,GAAG,YAAY,GAAG,QAAQ,CAAC;IAEpE,6BAA6B;IAC7B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAGjC,KAAK,EAAE;QACL,eAAe;QACf,EAAE,EAAE,MAAM,CAAC;QAEX,oBAAoB;QACpB,QAAQ,EAAE,MAAM,CAAC;QAEjB,uBAAuB;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAGF,QAAQ,CAAC,EAAE;QACT,uCAAuC;QACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAE1B,qCAAqC;QACrC,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,kBAAkB;QAClB,KAAK,CAAC,EAAE,UAAU,CAAC;QAEnB,kBAAkB;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,kDAAkD;QAClD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAEzB,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,yCAAyC;QACzC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAE/B,0BAA0B;QAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAE/B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAGlB,QAAQ,EAAE;QACR,iBAAiB;QACjB,SAAS,EAAE,MAAM,CAAC;QAElB,sCAAsC;QACtC,cAAc,EAAE,MAAM,CAAC;QAEvB,kCAAkC;QAClC,UAAU,EAAE,MAAM,CAAC;QAEnB,4CAA4C;QAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,qCAAqC;QACrC,WAAW,CAAC,EAAE,OAAO,CAAC;QAEtB,qCAAqC;QACrC,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAGF,mBAAmB;IACnB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IAEtC,mBAAmB;IACnB,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,UAAU,GACtD,kBAAkB,GAAG,cAAc,GAAG,YAAY,GAAG,QAAQ,CAAC;IAEpE,6BAA6B;IAC7B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAGjC,KAAK,EAAE;QACL,eAAe;QACf,EAAE,EAAE,MAAM,CAAC;QAEX,oBAAoB;QACpB,QAAQ,EAAE,MAAM,CAAC;QAEjB,uBAAuB;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAGF,QAAQ,CAAC,EAAE;QACT,uCAAuC;QACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAE1B,qCAAqC;QACrC,cAAc,CAAC,EAAE,MAAM,CAAC;QAExB,kBAAkB;QAClB,KAAK,CAAC,EAAE,UAAU,CAAC;QAEnB,kBAAkB;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,kDAAkD;QAClD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAEzB,oDAAoD;QACpD,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,yCAAyC;QACzC,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAE/B,0BAA0B;QAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IAEF;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/types",
-  "version": "4.53.0",
+  "version": "4.54.1",
   "description": "Shared TypeScript types for Nexus Cortex - breaks circular dependency between core and executors",
   "type": "module",
   "main": "./dist/index.js",