@xrkseek/harness-cli 0.1.0 → 0.1.2

package/node_modules/@xrkseek/xrk-session-reference/dist/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Public session-reference request, candidate, and preparation records.
+ * Face discovery imports stay on type-only subpaths; Cordis prepare lives in
+ * `index.ts` (not wired on XRK Host main path).
+ * @module @xrkseek/xrk-session-reference/types
+ */
+import type { ContentBlock, UserMessage } from '@xrkseek/protocol';
+/** Opaque session id (Face path; Cordis prepare uses branded ids when wired). */
+export type SessionId = string & {
+    readonly __xrkSessionId?: unique symbol;
+};
+/** Brand a raw session id string for URI codec helpers. */
+export declare function SessionId(id: string): SessionId;
+/** Durable source session, cited event seqs, and snapshot facts for prepared cross-session context. */
+export interface SessionReferenceSource {
+    kind: 'session-reference';
+    /** Material lifted out of another session's log (`recall` context form). */
+    form: 'recall';
+    version: 1;
+    references: {
+        sessionId: string;
+        label: string;
+        capturedThroughSeq: number | null;
+        compacted: boolean;
+        originalMessages: number;
+        retainedMessages: number;
+        omittedMessages: number;
+        omittedBytes: number;
+        truncated: boolean;
+        inputIndex: number;
+    }[];
+}
+/** One source session selected by a host. */
+export interface SessionReferenceInput {
+    /** Opaque source session identity. */
+    sessionId: SessionId;
+    /** Optional user-facing mention label. */
+    label?: string;
+}
+/** One host-facing candidate from exact session metadata. */
+export interface SessionReferenceCandidate {
+    /** Opaque source session identity. */
+    sessionId: SessionId;
+    /** Latest log-backed title, falling back to the opaque session id. */
+    label: string;
+    /** Source session working directory, when recorded. */
+    cwd?: string;
+    /** Source session creation time in Unix epoch milliseconds. */
+    createdAt: number;
+}
+/** One discovery candidate carrying its canonical prompt mention. */
+export interface SessionReferenceMentionCandidate extends SessionReferenceCandidate {
+    /** Canonical `@[label](dsh-session:…)` mention serialized into the prompt draft. */
+    mention: string;
+}
+/** Direct message content and optional referenced-session context. */
+export interface PreparedReferencedMessage {
+    /** Readable message content after host mention tokens are removed. */
+    content: ContentBlock[];
+    /** Aggregated untrusted snapshot, absent when the message has no references. */
+    additionalContext?: UserMessage;
+}
+/** Text-only projected conversation item. */
+export interface ReferencedConversationItem {
+    /** Original message role. */
+    role: 'user' | 'assistant';
+    /** Visible text retained from that message. */
+    text: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@xrkseek/xrk-session-reference/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAElE,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,MAAM,CAAA;CAAE,CAAA;AAE5E,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED,uGAAuG;AACvG,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,mBAAmB,CAAA;IACzB,4EAA4E;IAC5E,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,CAAC,CAAA;IACV,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;QACjC,SAAS,EAAE,OAAO,CAAA;QAClB,gBAAgB,EAAE,MAAM,CAAA;QACxB,gBAAgB,EAAE,MAAM,CAAA;QACxB,eAAe,EAAE,MAAM,CAAA;QACvB,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,OAAO,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;KACnB,EAAE,CAAA;CACJ;AAED,6CAA6C;AAC7C,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,SAAS,EAAE,SAAS,CAAA;IACpB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,6DAA6D;AAC7D,MAAM,WAAW,yBAAyB;IACxC,sCAAsC;IACtC,SAAS,EAAE,SAAS,CAAA;IACpB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,gCAAiC,SAAQ,yBAAyB;IACjF,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,WAAW,CAAA;CAChC;AAED,6CAA6C;AAC7C,MAAM,WAAW,0BAA0B;IACzC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;CACb"}

package/node_modules/@xrkseek/xrk-session-reference/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Public session-reference request, candidate, and preparation records.
+ * Face discovery imports stay on type-only subpaths; Cordis prepare lives in
+ * `index.ts` (not wired on XRK Host main path).
+ * @module @xrkseek/xrk-session-reference/types
+ */
+/** Brand a raw session id string for URI codec helpers. */
+export function SessionId(id) {
+    return id;
+}
+//# sourceMappingURL=types.js.map

package/node_modules/@xrkseek/xrk-session-reference/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,2DAA2D;AAC3D,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,EAAe,CAAA;AACxB,CAAC"}

package/node_modules/@xrkseek/xrk-session-reference/dist/uri.d.ts

@@ -0,0 +1,40 @@
+/** Canonical session URI and inline mention encoding. */
+import { type SessionId as SessionIdType } from './types.js';
+import type { SessionReferenceInput } from './types.js';
+/** URI scheme reserved for XRK-Harness session snapshots. */
+export declare const SESSION_REFERENCE_SCHEME = "dsh-session:";
+/**
+ * Encode any JavaScript session-id string as a canonical lossless URI.
+ * @param sessionId - opaque session id to serialize.
+ * @returns canonical `dsh-session:` URI.
+ */
+export declare function encodeSessionReferenceUri(sessionId: SessionIdType): string;
+/**
+ * Decode and canonicalize one session-reference URI.
+ * @param uri - complete canonical URI.
+ * @returns decoded session id.
+ */
+export declare function decodeSessionReferenceUri(uri: string): SessionIdType;
+/**
+ * Render a host-neutral Markdown mention carrying the canonical URI.
+ * @param reference - structured id and optional display label.
+ * @returns escaped `@[label](uri)` mention.
+ */
+export declare function formatSessionReferenceMention(reference: SessionReferenceInput): string;
+/** Result of extracting canonical mentions from plain text. */
+export interface ParsedSessionReferenceText {
+    /** Text with opaque tokens replaced by readable `@label` spans. */
+    text: string;
+    /** Structured references in first-appearance order, before service deduplication. */
+    references: SessionReferenceInput[];
+}
+/**
+ * Extract Markdown mentions and bare canonical URIs from one text value.
+ * Explicit Markdown mentions fail on any malformed URI. Bare text is treated
+ * as a reference only when it has a non-empty base64url-shaped payload, then
+ * still fails if that candidate is not canonical.
+ * @param text - host text to normalize.
+ * @returns readable text and structured references in appearance order.
+ */
+export declare function parseSessionReferenceText(text: string): ParsedSessionReferenceText;
+//# sourceMappingURL=uri.d.ts.map

package/node_modules/@xrkseek/xrk-session-reference/dist/uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.d.ts","sourceRoot":"","sources":["../src/uri.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,EAAa,KAAK,SAAS,IAAI,aAAa,EAAE,MAAM,YAAY,CAAA;AAEvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,iBAAiB,CAAA;AAEtD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAepE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,qBAAqB,GAAG,MAAM,CAGtF;AAED,+DAA+D;AAC/D,MAAM,WAAW,0BAA0B;IACzC,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ,qFAAqF;IACrF,UAAU,EAAE,qBAAqB,EAAE,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,CAkBlF"}

package/node_modules/@xrkseek/xrk-session-reference/dist/uri.js

@@ -0,0 +1,81 @@
+/** Canonical session URI and inline mention encoding. */
+import { SessionId } from './types.js';
+import { SessionReferenceError } from './config.js';
+/** URI scheme reserved for XRK-Harness session snapshots. */
+export const SESSION_REFERENCE_SCHEME = 'dsh-session:';
+/**
+ * Encode any JavaScript session-id string as a canonical lossless URI.
+ * @param sessionId - opaque session id to serialize.
+ * @returns canonical `dsh-session:` URI.
+ */
+export function encodeSessionReferenceUri(sessionId) {
+    const payload = Buffer.from(JSON.stringify(sessionId), 'utf8').toString('base64url');
+    return `${SESSION_REFERENCE_SCHEME}${payload}`;
+}
+/**
+ * Decode and canonicalize one session-reference URI.
+ * @param uri - complete canonical URI.
+ * @returns decoded session id.
+ */
+export function decodeSessionReferenceUri(uri) {
+    if (!uri.startsWith(SESSION_REFERENCE_SCHEME)) {
+        throw invalidUri(uri);
+    }
+    const payload = uri.slice(SESSION_REFERENCE_SCHEME.length);
+    if (!/^[A-Za-z0-9_-]+$/.test(payload))
+        throw invalidUri(uri);
+    try {
+        const parsed = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
+        if (typeof parsed !== 'string')
+            throw new TypeError('decoded session id is not a string');
+        const sessionId = SessionId(parsed);
+        if (encodeSessionReferenceUri(sessionId) !== uri)
+            throw new TypeError('URI is not canonical');
+        return sessionId;
+    }
+    catch (error) {
+        throw invalidUri(uri, error);
+    }
+}
+/**
+ * Render a host-neutral Markdown mention carrying the canonical URI.
+ * @param reference - structured id and optional display label.
+ * @returns escaped `@[label](uri)` mention.
+ */
+export function formatSessionReferenceMention(reference) {
+    const label = escapeLabel(reference.label ?? reference.sessionId);
+    return `@[${label}](${encodeSessionReferenceUri(reference.sessionId)})`;
+}
+/**
+ * Extract Markdown mentions and bare canonical URIs from one text value.
+ * Explicit Markdown mentions fail on any malformed URI. Bare text is treated
+ * as a reference only when it has a non-empty base64url-shaped payload, then
+ * still fails if that candidate is not canonical.
+ * @param text - host text to normalize.
+ * @returns readable text and structured references in appearance order.
+ */
+export function parseSessionReferenceText(text) {
+    const references = [];
+    const pattern = /@\[((?:\\.|[^\\\]])*)\]\((dsh-session:[^\s)]*)\)|(dsh-session:[A-Za-z0-9_-]+)/gu;
+    const rendered = text.replace(pattern, (_match, rawLabel, markdownUri, bareUri) => {
+        const uri = markdownUri ?? bareUri;
+        /* v8 ignore next -- the two-alternative regex always captures exactly one URI group. */
+        if (uri === undefined)
+            throw new SessionReferenceError('session reference URI is missing', 'SESSION_REFERENCE_INVALID_REFERENCE');
+        const sessionId = decodeSessionReferenceUri(uri);
+        const label = rawLabel === undefined ? sessionId : unescapeLabel(rawLabel);
+        references.push({ sessionId, label });
+        return `@${label}`;
+    });
+    return { text: rendered, references };
+}
+function escapeLabel(label) {
+    return label.replace(/[\\\]]/gu, match => `\\${match}`);
+}
+function unescapeLabel(label) {
+    return label.replace(/\\(.)/gu, '$1');
+}
+function invalidUri(uri, cause) {
+    return new SessionReferenceError(`invalid session reference URI ${JSON.stringify(uri)}`, 'SESSION_REFERENCE_INVALID_REFERENCE', cause === undefined ? undefined : { cause });
+}
+//# sourceMappingURL=uri.js.map

package/node_modules/@xrkseek/xrk-session-reference/dist/uri.js.map

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

package/node_modules/@xrkseek/xrk-session-reference/package.json

@@ -8,72 +8,32 @@
     "directory": "packages/context/session-reference"
   },
   "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
   "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./types": {
-      "types": "./src/types.ts",
-      "default": "./src/types.ts"
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
     },
     "./config": {
-      "types": "./src/config.ts",
-      "default": "./src/config.ts"
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
     },
     "./uri": {
-      "types": "./src/uri.ts",
-      "default": "./src/uri.ts"
-    },
-    "./typert": {
-      "types": "./lib/typert.host.d.ts",
-      "default": "./lib/typert.host.js"
+      "types": "./dist/uri.d.ts",
+      "import": "./dist/uri.js",
+      "default": "./dist/uri.js"
     },
-    "./remote": {
-      "types": "./lib/typert.remote-client.d.ts",
-      "default": "./lib/typert.remote-client.js"
-    },
-    "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
-    "lib/index.js",
-    "lib/invariant.js",
-    "lib/types/**/*.js",
-    "lib/types/**/*.d.ts",
-    "lib/typert.host.js",
-    "lib/typert.host.d.ts",
-    "lib/typert.remote-client.js",
-    "lib/typert.remote-client.d.ts"
+    "dist",
+    "README.md",
+    "README.zh.md"
   ],
   "license": "MIT",
   "dependencies": {
-    "@xrkseek/schemastery": "workspace:^",
-    "zod": "^4.4.3"
-  },
-  "peerDependencies": {
-    "@xrkseek/xrk-agent": "workspace:^",
-    "@xrkseek/xrk-compaction": "workspace:^",
-    "@xrkseek/xrk-invariants": "workspace:^",
-    "@xrkseek/xrk-llm": "workspace:^",
-    "@xrkseek/xrk-session": "workspace:^",
-    "@xrkseek/xrk-typert-protocol": "workspace:^",
-    "@xrkseek/cordis": "workspace:^"
-  },
-  "devDependencies": {
-    "@xrkseek/xrk-agent": "workspace:^",
-    "@xrkseek/xrk-compaction": "workspace:^",
-    "@xrkseek/xrk-invariants": "workspace:^",
-    "@xrkseek/xrk-llm": "workspace:^",
-    "@xrkseek/xrk-session": "workspace:^",
-    "@xrkseek/xrk-typert-protocol": "workspace:^",
-    "@xrkseek/cordis": "workspace:^"
+    "@xrkseek/protocol": "workspace:*"
   },
   "private": true
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xrkseek/harness-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "XRK-Harness CLI (run / serve / web / plugin). Product shell ships in product-web/.",
   "type": "module",
   "exports": {
@@ -16,7 +16,8 @@
     "README.md"
   ],
   "bin": {
-    "xrk-harness": "./dist/bin.js"
+    "xrk-harness": "./dist/bin.js",
+    "xrkh": "./dist/bin.js"
   },
   "dependencies": {
     "@hono/node-server": "2.1.1",

package/product-web/boot.json

@@ -1,5 +1,5 @@
 {
-  "rev": "xrk-web-1787499778898",
+  "rev": "xrk-web-1787502421192",
   "entries": [
     {
       "id": "@xrkseek/client-connection",