@deepseek-ai/dsh-session-title 0.0.1-rc.1

package/lib/types/normalize.js

@@ -0,0 +1,71 @@
+/** Title text normalization and UTF-8-safe truncation. */
+/** Operating-system-command escape sequences, including unterminated tails. */
+const OSC_SEQUENCE = /(?:\u001B\]|\u009D)(?:(?!\u0007|\u001B\\)[\s\S])*(?:\u0007|\u001B\\|$)/gu;
+/** Control-sequence-introducer escapes such as SGR color codes. */
+const CSI_SEQUENCE = /(?:\u001B\[|\u009B)[0-?]*[ -/]*[@-~]/gu;
+/** Remaining two-byte ESC control sequences. */
+const ESC_SEQUENCE = /\u001B[@-_]/gu;
+/** Non-whitespace C0/C1 control characters. */
+const CONTROL_CHARACTER = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/gu;
+/** Directional and invisible controls that can make a displayed title deceptive. */
+const DIRECTIONAL_CONTROL = /[\u200B\u200E\u200F\u202A-\u202E\u2060-\u2064\u2066-\u206F\uFEFF]/gu;
+/** Reject an invalid public text limit. */
+function assertPositiveInteger(name, value) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${name} must be a positive integer`);
+    }
+}
+/** Remove controls and produce one trimmed, whitespace-normalized line. */
+function cleanTitleText(input) {
+    return input
+        .replace(OSC_SEQUENCE, '')
+        .replace(CSI_SEQUENCE, '')
+        .replace(ESC_SEQUENCE, '')
+        .replace(CONTROL_CHARACTER, '')
+        .replace(DIRECTIONAL_CONTROL, '')
+        .replace(/\s+/gu, ' ')
+        .trim();
+}
+/**
+ * Truncate a string to a UTF-8 byte budget without splitting a Unicode code point.
+ * @param input - normalized title text.
+ * @param maxBytes - positive UTF-8 byte budget.
+ * @returns the longest leading code-point prefix within the budget.
+ */
+export function truncateTitleUtf8(input, maxBytes) {
+    assertPositiveInteger('maxBytes', maxBytes);
+    if (Buffer.byteLength(input, 'utf8') <= maxBytes)
+        return input;
+    let used = 0;
+    let output = '';
+    for (const character of input) {
+        const bytes = Buffer.byteLength(character, 'utf8');
+        if (used + bytes > maxBytes)
+            break;
+        output += character;
+        used += bytes;
+    }
+    return output;
+}
+/**
+ * Normalize one accepted session title and enforce its UTF-8 byte budget.
+ * @param input - untrusted title text.
+ * @param maxBytes - positive maximum encoded size.
+ * @returns a terminal-safe one-line title, possibly empty after sanitization.
+ */
+export function normalizeSessionTitle(input, maxBytes) {
+    return truncateTitleUtf8(cleanTitleText(input), maxBytes).trimEnd();
+}
+/**
+ * Derive the deterministic first-message fallback.
+ * @param input - text from the first eligible human message.
+ * @param maxWords - positive whitespace-delimited word cap.
+ * @param maxBytes - positive UTF-8 byte cap.
+ * @returns the normalized leading words within both limits.
+ */
+export function fallbackSessionTitle(input, maxWords, maxBytes) {
+    assertPositiveInteger('maxWords', maxWords);
+    const words = cleanTitleText(input).split(' ').filter(Boolean).slice(0, maxWords);
+    return truncateTitleUtf8(words.join(' '), maxBytes).trimEnd();
+}
+//# sourceMappingURL=normalize.js.map

package/lib/types/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure types of the title domain: the ONE home of the `title` projection-key
+ * declaration, free of this package's host-side value imports (cordis
+ * service, schemastery, the llm seam). Two namespace projections serve it —
+ * `./types` for host consumers, `./client/types` (the browser half-entry's
+ * re-export) for client aggregates — with zero content duplication.
+ *
+ * @module @deepseek-ai/dsh-session-title/types
+ */
+export {};
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionMap {
+        /**
+         * The session's current normalized title — the latest `session/title`
+         * event's text (last-wins), or `null` before the first title lands. A
+         * plain string: the shape the client list rows consume.
+         */
+        title: string | null;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -0,0 +1,11 @@
+/**
+ * Pure types of the title domain: the ONE home of the `title` projection-key
+ * declaration, free of this package's host-side value imports (cordis
+ * service, schemastery, the llm seam). Two namespace projections serve it —
+ * `./types` for host consumers, `./client/types` (the browser half-entry's
+ * re-export) for client aggregates — with zero content duplication.
+ *
+ * @module @deepseek-ai/dsh-session-title/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@deepseek-ai/dsh-session-title",
+  "description": "Log-backed session title service and provider registry for the DeepSeek Harness",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/session/session-title"
+  },
+  "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": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./client": {
+      "types": "./lib/types/client.d.ts",
+      "default": "./lib/types/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "BSD-3-Clause",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-brand": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@deepseek-ai/schemastery": "^3.18.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-brand": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session-persistence-sqlite": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  }
+}