@prur/dsh-chat-service 0.1.14

package/lib/typert.host.js

@@ -0,0 +1,155 @@
+/**
+ * Hand-written TYPERT host manifest for the chat Remote namespace. The
+ * official typert generator emits this artifact from the service face during
+ * the harness repository build; this package hand-writes the same contract
+ * (wire schemas + invocation descriptors) because the bridge repo builds
+ * packages with plain tsc. The typert-loader validates every field at mount
+ * time; the isolated-instance matrix asserts acceptance on boot.
+ * @module @prur/dsh-chat-service/typert
+ */
+import { z } from 'zod';
+const conversationIdSchema = z.string().regex(/^[A-Za-z0-9_-]{1,64}$/);
+const optionalStringSchema = z.string().min(1).optional();
+const optionalNumberSchema = z.number().int().nonnegative().optional();
+const optionalPositiveIntSchema = z.number().int().positive().optional();
+const textBlockSchema = z.object({
+    type: z.literal('text'),
+    text: z.string(),
+}).readonly();
+const messageSchema = z.object({
+    seq: z.number().int().nonnegative(),
+    role: z.enum(['user', 'assistant', 'system']),
+    blocks: z.array(textBlockSchema).readonly(),
+    model: z.string().optional(),
+    provider: z.string().optional(),
+    createdAt: z.number().int().nonnegative().optional(),
+    error: z.string().optional(),
+}).readonly();
+const summarySchema = z.object({
+    conversationId: conversationIdSchema,
+    title: z.string().nullable(),
+    provider: z.string(),
+    model: z.string(),
+    updatedAt: z.number().int().nonnegative(),
+    messageCount: z.number().int().nonnegative(),
+    running: z.boolean(),
+}).readonly();
+const settingsSchema = z.object({
+    conversationId: conversationIdSchema,
+    title: z.string().nullable(),
+    provider: z.string(),
+    model: z.string(),
+    temperature: z.number().nullable(),
+    contextMessages: z.number().int().positive().nullable(),
+    systemPrompt: z.string().nullable(),
+    updatedAt: z.number().int().nonnegative(),
+}).readonly();
+const patchSchema = z.object({
+    systemPrompt: z.string().nullable().optional(),
+    temperature: z.number().nullable().optional(),
+    contextMessages: z.number().int().positive().nullable().optional(),
+}).readonly();
+const contentSchema = z.array(textBlockSchema).min(1).readonly();
+const emptyOkSchema = z.object({}).readonly();
+const listResultSchema = z.object({
+    ok: z.literal(true),
+    value: z.object({ items: z.array(summarySchema).readonly() }),
+}).readonly();
+const createResultSchema = z.object({
+    ok: z.literal(true),
+    value: z.object({ conversationId: conversationIdSchema }),
+}).readonly();
+const emptyResultSchema = z.object({
+    ok: z.literal(true),
+    value: emptyOkSchema,
+}).readonly();
+const historyResultSchema = z.object({
+    ok: z.literal(true),
+    value: z.object({
+        items: z.array(messageSchema).readonly(),
+        hasMore: z.boolean(),
+    }),
+}).readonly();
+const sendResultSchema = z.object({
+    ok: z.literal(true),
+    value: z.object({ accepted: z.literal(true) }),
+}).readonly();
+const selectModelResultSchema = z.object({
+    ok: z.literal(true),
+    value: z.object({ provider: z.string(), model: z.string() }),
+}).readonly();
+const updateResultSchema = z.object({
+    ok: z.literal(true),
+    value: settingsSchema,
+}).readonly();
+const RESULT_TYPE_SYMBOLS = {
+    list: '@prur/dsh-chat-service/types#ChatListResult',
+    create: '@prur/dsh-chat-service/types#ChatCreateResult',
+    rename: '@prur/dsh-chat-service/types#ChatEmptyResult',
+    delete: '@prur/dsh-chat-service/types#ChatEmptyResult',
+    history: '@prur/dsh-chat-service/types#ChatHistoryResult',
+    send: '@prur/dsh-chat-service/types#ChatSendResult',
+    cancel: '@prur/dsh-chat-service/types#ChatEmptyResult',
+    selectModel: '@prur/dsh-chat-service/types#ChatSelectModelResult',
+    update: '@prur/dsh-chat-service/types#ChatUpdateResult',
+};
+const invocation = (id, method, parameters, result) => ({
+    id: `@prur/dsh-chat-service#${id}`,
+    service: 'chat',
+    namespace: 'chat',
+    method,
+    invocation: { kind: 'direct' },
+    parameters,
+    result: {
+        mode: 'strict',
+        typeSymbol: RESULT_TYPE_SYMBOLS[method],
+        schema: result,
+    },
+});
+export const TYPERT = {
+    package: '@prur/dsh-chat-service',
+    face: 'host',
+    schemas: [],
+    invocations: [
+        invocation('chat/list', 'list', [], listResultSchema),
+        invocation('chat/create', 'create', [
+            { name: 'provider', wire: 'provider', source: 'json', acceptsUndefined: true, codec: { mode: 'strict', typeSymbol: 'string', schema: optionalStringSchema } },
+            { name: 'model', wire: 'model', source: 'json', acceptsUndefined: true, codec: { mode: 'strict', typeSymbol: 'string', schema: optionalStringSchema } },
+            { name: 'title', wire: 'title', source: 'json', acceptsUndefined: true, codec: { mode: 'strict', typeSymbol: 'string', schema: optionalStringSchema } },
+        ], createResultSchema),
+        invocation('chat/rename', 'rename', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: conversationIdSchema } },
+            { name: 'title', wire: 'title', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: z.string().min(1) } },
+        ], emptyResultSchema),
+        invocation('chat/delete', 'delete', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: conversationIdSchema } },
+        ], emptyResultSchema),
+        invocation('chat/history', 'history', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: conversationIdSchema } },
+            { name: 'beforeSeq', wire: 'beforeSeq', source: 'json', acceptsUndefined: true, codec: { mode: 'strict', typeSymbol: 'number', schema: optionalNumberSchema } },
+            { name: 'maxMessages', wire: 'maxMessages', source: 'json', acceptsUndefined: true, codec: { mode: 'strict', typeSymbol: 'number', schema: optionalPositiveIntSchema } },
+        ], historyResultSchema),
+        invocation('chat/send', 'send', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: conversationIdSchema } },
+            { name: 'content', wire: 'content', source: 'json', codec: { mode: 'strict', typeSymbol: '@prur/dsh-chat-service/types#ChatTextBlock[]', schema: contentSchema } },
+        ], sendResultSchema),
+        invocation('chat/cancel', 'cancel', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: conversationIdSchema } },
+        ], emptyResultSchema),
+        invocation('chat/selectModel', 'selectModel', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: conversationIdSchema } },
+            { name: 'provider', wire: 'provider', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: z.string().min(1) } },
+            { name: 'model', wire: 'model', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: z.string().min(1) } },
+        ], selectModelResultSchema),
+        invocation('chat/update', 'update', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json', codec: { mode: 'strict', typeSymbol: 'string', schema: conversationIdSchema } },
+            { name: 'patch', wire: 'patch', source: 'json', codec: { mode: 'strict', typeSymbol: '@prur/dsh-chat-service/types#ChatUpdatePatch', schema: patchSchema } },
+        ], updateResultSchema),
+    ],
+    model: {
+        services: [],
+        events: [],
+        objects: [],
+    },
+};
+export default TYPERT;

package/lib/typert.remote-client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Client projection of the chat Remote namespace, mirroring the
+ * `typert.remote-client` artifact the official generator emits. Inert while
+ * the package declares no client half (`dsh: null`); kept for contract
+ * completeness and future client tooling.
+ * @module @prur/dsh-chat-service/remote
+ */
+/** One remote-client invocation descriptor (mirror of the host face). */
+interface RemoteInvocationEntry {
+    readonly id: string;
+    readonly service: string;
+    readonly namespace: string;
+    readonly method: string;
+    readonly invocation: {
+        readonly kind: 'direct';
+    };
+    readonly parameters: readonly {
+        readonly name: string;
+        readonly wire: string;
+        readonly source: 'json';
+        readonly acceptsUndefined?: true;
+    }[];
+    readonly result: {
+        readonly mode: 'strict';
+        readonly typeSymbol: string;
+    };
+}
+export declare const TYPERT_REMOTE: {
+    package: string;
+    descriptors: RemoteInvocationEntry[];
+};
+export default TYPERT_REMOTE;

package/lib/typert.remote-client.js

@@ -0,0 +1,70 @@
+/**
+ * Client projection of the chat Remote namespace, mirroring the
+ * `typert.remote-client` artifact the official generator emits. Inert while
+ * the package declares no client half (`dsh: null`); kept for contract
+ * completeness and future client tooling.
+ * @module @prur/dsh-chat-service/remote
+ */
+const RESULT_TYPE_SYMBOLS = {
+    list: '@prur/dsh-chat-service/types#ChatListResult',
+    create: '@prur/dsh-chat-service/types#ChatCreateResult',
+    rename: '@prur/dsh-chat-service/types#ChatEmptyResult',
+    delete: '@prur/dsh-chat-service/types#ChatEmptyResult',
+    history: '@prur/dsh-chat-service/types#ChatHistoryResult',
+    send: '@prur/dsh-chat-service/types#ChatSendResult',
+    cancel: '@prur/dsh-chat-service/types#ChatEmptyResult',
+    selectModel: '@prur/dsh-chat-service/types#ChatSelectModelResult',
+    update: '@prur/dsh-chat-service/types#ChatUpdateResult',
+};
+const descriptor = (id, method, parameters) => ({
+    id: `@prur/dsh-chat-service#${id}`,
+    service: 'chat',
+    namespace: 'chat',
+    method,
+    invocation: { kind: 'direct' },
+    parameters,
+    result: {
+        mode: 'strict',
+        typeSymbol: RESULT_TYPE_SYMBOLS[method],
+    },
+});
+export const TYPERT_REMOTE = {
+    package: '@prur/dsh-chat-service',
+    descriptors: [
+        descriptor('chat/list', 'list', []),
+        descriptor('chat/create', 'create', [
+            { name: 'provider', wire: 'provider', source: 'json', acceptsUndefined: true },
+            { name: 'model', wire: 'model', source: 'json', acceptsUndefined: true },
+            { name: 'title', wire: 'title', source: 'json', acceptsUndefined: true },
+        ]),
+        descriptor('chat/rename', 'rename', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json' },
+            { name: 'title', wire: 'title', source: 'json' },
+        ]),
+        descriptor('chat/delete', 'delete', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json' },
+        ]),
+        descriptor('chat/history', 'history', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json' },
+            { name: 'beforeSeq', wire: 'beforeSeq', source: 'json', acceptsUndefined: true },
+            { name: 'maxMessages', wire: 'maxMessages', source: 'json', acceptsUndefined: true },
+        ]),
+        descriptor('chat/send', 'send', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json' },
+            { name: 'content', wire: 'content', source: 'json' },
+        ]),
+        descriptor('chat/cancel', 'cancel', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json' },
+        ]),
+        descriptor('chat/selectModel', 'selectModel', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json' },
+            { name: 'provider', wire: 'provider', source: 'json' },
+            { name: 'model', wire: 'model', source: 'json' },
+        ]),
+        descriptor('chat/update', 'update', [
+            { name: 'conversationId', wire: 'conversationId', source: 'json' },
+            { name: 'patch', wire: 'patch', source: 'json' },
+        ]),
+    ],
+};
+export default TYPERT_REMOTE;

package/lib/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Wire types for the chat Typert Remote namespace: a plain model chat domain
+ * that never enters the session/agent loop. The host-side authoritative
+ * shape lives here; the DSH-Mobile SDK mirrors it in `ChatRemoteClient`.
+ * @module @prur/dsh-chat-service/src/types
+ */
+/** One text content block (v1 keeps chat text-only; image blocks arrive with M3). */
+export interface ChatTextBlock {
+    readonly type: 'text';
+    readonly text: string;
+}
+/** Reason a running turn settled, carried by the `chat/status` event. */
+export type ChatTurnReason = 'completed' | 'aborted' | 'error' | 'max-tokens' | 'context-trimmed';
+/**
+ * One chat message node. `seq` is the conversation's monotonic message
+ * sequence (identity and reconnect-convergence anchor — never reused).
+ */
+export interface ChatMessage {
+    readonly seq: number;
+    readonly role: 'user' | 'assistant' | 'system';
+    readonly blocks: readonly ChatTextBlock[];
+    /** Provider route that produced an assistant message. */
+    readonly model?: string;
+    /** Provider route key that produced an assistant message. */
+    readonly provider?: string;
+    /** Unix epoch milliseconds when the message settled. */
+    readonly createdAt?: number;
+    /** Presentation string when an assistant turn failed. */
+    readonly error?: string;
+}
+/** Live run state of one conversation. */
+export interface ChatStatus {
+    readonly running: boolean;
+    /** Identity of the settled-or-in-flight assistant turn (its message seq). */
+    readonly turn: number;
+    readonly reason?: ChatTurnReason;
+}
+/** One conversation row for `chat/list`. */
+export interface ChatConversationSummary {
+    readonly conversationId: string;
+    readonly title: string | null;
+    readonly provider: string;
+    readonly model: string;
+    /** Unix epoch milliseconds of the last message or setting change. */
+    readonly updatedAt: number;
+    readonly messageCount: number;
+    readonly running: boolean;
+}
+/** Settings view of one conversation (returned by `chat/update`). */
+export interface ChatConversationSettings {
+    readonly conversationId: string;
+    readonly title: string | null;
+    readonly provider: string;
+    readonly model: string;
+    readonly temperature: number | null;
+    readonly contextMessages: number | null;
+    readonly systemPrompt: string | null;
+    readonly updatedAt: number;
+}
+/** Successful chats of `chat/list`. */
+export type ChatListResult = {
+    readonly ok: true;
+    readonly value: {
+        readonly items: readonly ChatConversationSummary[];
+    };
+};
+/** Successful value of `chat/create`. */
+export type ChatCreateResult = {
+    readonly ok: true;
+    readonly value: {
+        readonly conversationId: string;
+    };
+};
+/** Successful value of `chat/rename` and `chat/delete`. */
+export type ChatEmptyResult = {
+    readonly ok: true;
+    readonly value: Record<string, never>;
+};
+/** Successful value of `chat/history`. */
+export type ChatHistoryResult = {
+    readonly ok: true;
+    readonly value: {
+        readonly items: readonly ChatMessage[];
+        readonly hasMore: boolean;
+    };
+};
+/** Successful value of `chat/send`. */
+export type ChatSendResult = {
+    readonly ok: true;
+    readonly value: {
+        readonly accepted: true;
+    };
+};
+/** Successful value of `chat/selectModel`. */
+export type ChatSelectModelResult = {
+    readonly ok: true;
+    readonly value: {
+        readonly provider: string;
+        readonly model: string;
+    };
+};
+/** Successful value of `chat/update`. */
+export type ChatUpdateResult = {
+    readonly ok: true;
+    readonly value: ChatConversationSettings;
+};

package/lib/types.js

@@ -0,0 +1,7 @@
+/**
+ * Wire types for the chat Typert Remote namespace: a plain model chat domain
+ * that never enters the session/agent loop. The host-side authoritative
+ * shape lives here; the DSH-Mobile SDK mirrors it in `ChatRemoteClient`.
+ * @module @prur/dsh-chat-service/src/types
+ */
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@prur/dsh-chat-service",
+  "version": "0.1.14",
+  "description": "Typert Remote namespace exposing a plain streaming model chat (no agent loop) to DSH Mobile clients",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prur/dsh-mobile-host-bridge.git",
+    "directory": "packages/chat-service"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./types": {
+      "types": "./lib/types.d.ts",
+      "default": "./lib/types.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": null,
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "ws": "^8.21.0",
+    "@prur/dsh-client-connection-mobile": "^0.1.14"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8 || ^0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8 || ^0.1.1-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.0-rc.8 || ^0.1.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.8 || ^0.1.1-rc.2"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/*.d.ts"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}