@deepseekharness-mobile/companion 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 joseph12n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,80 @@
-# Temporary Holding Version
+<div align="center">
+  <img src="https://raw.githubusercontent.com/joseph12n/dsh-mobile/main/docs/assets/logo.png" width="88" alt="DSH Mobile" />
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+  <h1>@deepseekharness-mobile/companion</h1>
+
+  <p><strong>The host plugin for DSH Mobile.</strong><br />
+  Serves the PWA, pairs phones and bridges the <code>dsh-mobile/1</code> contract to DeepSeek
+  Harness — loopback-only, one token per device, no cloud in between.</p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/@deepseekharness-mobile/companion"><img src="https://img.shields.io/npm/v/@deepseekharness-mobile/companion?label=npm&color=4D6BFE" alt="npm" /></a>
+    <a href="https://www.npmjs.com/package/@deepseekharness-mobile/companion"><img src="https://img.shields.io/npm/dm/@deepseekharness-mobile/companion?color=4D6BFE" alt="Downloads" /></a>
+    <a href="https://github.com/joseph12n/dsh-mobile/actions/workflows/ci.yml"><img src="https://github.com/joseph12n/dsh-mobile/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+    <a href="https://sonarcloud.io/summary/new_code?id=joseph12n_dsh-mobile"><img src="https://sonarcloud.io/api/project_badges/measure?project=joseph12n_dsh-mobile&metric=alert_status" alt="Quality Gate" /></a>
+    <a href="https://github.com/joseph12n/dsh-mobile/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-4D6BFE.svg" alt="License" /></a>
+    <a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/DeepSeek%20Harness-companion-4D6BFE?logo=deepseek&logoColor=white" alt="DeepSeek Harness" /></a>
+    <a href="https://github.com/joseph12n/dsh-mobile/blob/main/docs/phone-setup.md"><img src="https://img.shields.io/badge/PWA-installable-5A0FC8?logo=googlechrome&logoColor=white" alt="PWA" /></a>
+  </p>
+
+  <p>
+    <img src="https://raw.githubusercontent.com/joseph12n/dsh-mobile/main/docs/assets/session.png" width="215" alt="A live turn with the agent activity panel" />
+    <img src="https://raw.githubusercontent.com/joseph12n/dsh-mobile/main/docs/assets/settings.png" width="215" alt="Model providers and paired devices" />
+  </p>
+</div>
+
+## Install
+
+```sh
+dsh profile add @deepseekharness-mobile/companion
+```
+
+The profile reads the bundle's `cordis.patch.yml`, mounts the plugin and serves the embedded
+PWA on `127.0.0.1:6768`. Restart DSH afterwards, run `/mobile` in a session and open the link
+on the phone; the PWA installs from the browser menu.
+
+The listener is **loopback-only** by design: the phone reaches it through the tailnet name with
+`tailscale serve`, which provides HTTPS and a secure context. The full path, with the usual
+problems, is in
+[`docs/phone-setup.md`](https://github.com/joseph12n/dsh-mobile/blob/main/docs/phone-setup.md).
+
+## What the phone gets
+
+- **Live transcript** with paged history, separated reasoning and streaming events.
+- **Questions and approvals**, including the blocking `ask_user_question`, in an inline card.
+- **Agent activity**: goal and round, running subagents and open tasks in a floating panel that
+  does not shrink the conversation.
+- **Slash commands** from the composer, with the result outside the model transcript.
+- **Model providers**: test a key and connect it; the key is stored on the host and never comes
+  back, and endpoints, headers, model overrides and OAuth stay on the desktop.
+- **Paired devices**: last seen, revoke and forget, with the host revoking first.
+- **Sessions, folders, model choice**, write and cancel, and an installable PWA with four
+  locales.
+
+The full feature tour, the architecture and the security model live in the
+[repository README](https://github.com/joseph12n/dsh-mobile#readme).
+
+## Security
+
+- **Loopback only.** The listen address is a constant, not an option; the tailnet name is the
+  only supported path and LAN access is not implemented.
+- **Pair before anything.** The QR carries a single-use code in the URL fragment, valid for
+  10 minutes and never written to a log; redeeming it creates a device token stored as a hash.
+- **One token per device.** Revoking one cuts its sockets and does not affect the others.
+- **The host decides.** Capabilities are negotiated in `hello.ok`; the client cannot see or do
+  what the server does not send.
+
+## Documentation
+
+- [Repository](https://github.com/joseph12n/dsh-mobile) — the product, the features and the
+  screenshots.
+- [Phone setup](https://github.com/joseph12n/dsh-mobile/blob/main/docs/phone-setup.md) —
+  Tailscale, pairing and the usual problems.
+- [Architecture](https://github.com/joseph12n/dsh-mobile/blob/main/docs/architecture.md) — why
+  it is built this way.
+- [`@deepseekharness-mobile/protocol`](https://www.npmjs.com/package/@deepseekharness-mobile/protocol)
+  — the wire contract, also on npm.
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,20 @@
+# Capa de patch del plugin DSH Mobile.
+#
+# Se enlaza desde el perfil con `link:` en package.json y se activa añadiendo el
+# bundle a `dsh.profile.bundles`, o bien insertando esta entrada en el
+# `cordis.patch.yml` del perfil:
+#
+#   - insert:
+#       - id: dsh-mobile-companion
+#         name: '@deepseekharness-mobile/companion'
+#         config: {}
+#
+# El plugin escucha en 127.0.0.1:6768 (loopback fijo: no hay modo de red). La
+# autenticación por dispositivo ya existe; para llegar desde un teléfono se
+# publica por el nombre del tailnet con `tailscale serve`, que sí alcanza el
+# loopback y aporta HTTPS. La LAN directa no está soportada.
+
+- insert:
+    - id: dsh-mobile-companion
+      name: './dist/index.js'
+      config: {}

package/dist/core/devices.d.ts

@@ -0,0 +1,35 @@
+export interface Device {
+    id: string;
+    name: string;
+    platform: string;
+    createdAt: number;
+    lastSeenAt: number;
+}
+export interface StoredDevice extends Device {
+    tokenHash: string;
+}
+export interface DevicePersistence {
+    load(): StoredDevice[];
+    save(devices: StoredDevice[]): void;
+}
+export interface DeviceRegistryOptions {
+    persistence: DevicePersistence;
+    now?: () => number;
+    generateToken?: () => string;
+    generateId?: () => string;
+}
+export interface Enrolled {
+    device: Device;
+    token: string;
+}
+export declare function hashToken(token: string): string;
+export declare class DeviceRegistry {
+    #private;
+    constructor(options: DeviceRegistryOptions);
+    enroll(name: string, platform: string): Enrolled;
+    authenticate(token: string): Device | undefined;
+    flush(): void;
+    list(): Device[];
+    revoke(id: string): boolean;
+}
+//# sourceMappingURL=devices.d.ts.map

package/dist/core/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../src/core/devices.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,YAAY,EAAE,CAAC;IACvB,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,qBAAa,cAAc;;gBAQb,OAAO,EAAE,qBAAqB;IAgB1C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAkBhD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW/C,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,MAAM,EAAE;IAIhB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAc5B"}

package/dist/core/devices.js

@@ -0,0 +1,90 @@
+import { createHash, randomBytes, randomUUID } from 'node:crypto';
+export function hashToken(token) {
+    return createHash('sha256').update(token, 'utf8').digest('hex');
+}
+export class DeviceRegistry {
+    #persistence;
+    #now;
+    #generateToken;
+    #generateId;
+    #devices;
+    #dirty = false;
+    constructor(options) {
+        this.#persistence = options.persistence;
+        this.#now = options.now ?? (() => Date.now());
+        this.#generateToken = options.generateToken ?? (() => randomBytes(32).toString('base64url'));
+        this.#generateId = options.generateId ?? (() => randomUUID());
+        this.#devices = this.#loadSafely();
+    }
+    #loadSafely() {
+        try {
+            return this.#persistence.load();
+        }
+        catch {
+            return [];
+        }
+    }
+    enroll(name, platform) {
+        const now = this.#now();
+        const token = this.#generateToken();
+        const stored = {
+            id: this.#generateId(),
+            name: name.trim().slice(0, 64) || 'Device',
+            platform: platform.slice(0, 64),
+            createdAt: now,
+            lastSeenAt: now,
+            tokenHash: hashToken(token),
+        };
+        this.#devices = [...this.#devices, stored];
+        this.#persist();
+        return { device: toPublic(stored), token };
+    }
+    authenticate(token) {
+        if (!token)
+            return undefined;
+        const hash = hashToken(token);
+        const found = this.#devices.find((device) => safeEqual(device.tokenHash, hash));
+        if (!found)
+            return undefined;
+        found.lastSeenAt = this.#now();
+        this.#dirty = true;
+        return toPublic(found);
+    }
+    flush() {
+        if (!this.#dirty)
+            return;
+        this.#persist();
+    }
+    list() {
+        return this.#devices.map(toPublic);
+    }
+    revoke(id) {
+        const before = this.#devices.length;
+        this.#devices = this.#devices.filter((device) => device.id !== id);
+        if (this.#devices.length === before)
+            return false;
+        this.#persist();
+        return true;
+    }
+    #persist() {
+        try {
+            this.#persistence.save(this.#devices);
+            this.#dirty = false;
+        }
+        catch { }
+    }
+}
+function toPublic(stored) {
+    const { tokenHash: _ignored, ...device } = stored;
+    return device;
+}
+function safeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let index = 0; index < a.length; index += 1) {
+        diff |= a.charCodeAt(index) ^ b.charCodeAt(index);
+    }
+    return diff === 0;
+}
+//# sourceMappingURL=devices.js.map

package/dist/core/devices.js.map

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

package/dist/core/pairing.d.ts

@@ -0,0 +1,21 @@
+export declare const CODE_BYTES = 16;
+export declare const DEFAULT_TTL_MS: number;
+export declare function normalizeCode(raw: string): string;
+export interface IssuedCode {
+    code: string;
+    expiresAt: number;
+}
+export type RedeemResult = 'ok' | 'unknown' | 'expired' | 'consumed';
+export interface PairingOptions {
+    ttlMs?: number;
+    now?: () => number;
+    generate?: () => string;
+}
+export declare class PairingService {
+    #private;
+    constructor(options?: PairingOptions);
+    issue(): IssuedCode;
+    redeem(raw: string): RedeemResult;
+    pending(): IssuedCode[];
+}
+//# sourceMappingURL=pairing.d.ts.map

package/dist/core/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../src/core/pairing.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,eAAO,MAAM,cAAc,QAAiB,CAAC;AAmB7C,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;CACzB;AAOD,qBAAa,cAAc;;gBAMb,OAAO,GAAE,cAAmB;IAMxC,KAAK,IAAI,UAAU;IAQnB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAejC,OAAO,IAAI,UAAU,EAAE;CAcxB"}

package/dist/core/pairing.js

@@ -0,0 +1,74 @@
+import { randomBytes } from 'node:crypto';
+const ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+export const CODE_BYTES = 16;
+export const DEFAULT_TTL_MS = 10 * 60 * 1000;
+function encodeBase32(bytes) {
+    let out = '';
+    let buffer = 0;
+    let bits = 0;
+    for (const byte of bytes) {
+        buffer = (buffer << 8) | byte;
+        bits += 8;
+        while (bits >= 5) {
+            bits -= 5;
+            out += ALPHABET[(buffer >>> bits) & 31];
+        }
+    }
+    if (bits > 0)
+        out += ALPHABET[(buffer << (5 - bits)) & 31];
+    return out;
+}
+export function normalizeCode(raw) {
+    return raw
+        .toUpperCase()
+        .replace(/[^0-9A-Z]/g, '')
+        .replace(/[IL]/g, '1')
+        .replace(/O/g, '0');
+}
+export class PairingService {
+    #ttlMs;
+    #now;
+    #generate;
+    #codes = new Map();
+    constructor(options = {}) {
+        this.#ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+        this.#now = options.now ?? (() => Date.now());
+        this.#generate = options.generate ?? (() => encodeBase32(randomBytes(CODE_BYTES)));
+    }
+    issue() {
+        this.#prune();
+        const code = normalizeCode(this.#generate());
+        const expiresAt = this.#now() + this.#ttlMs;
+        this.#codes.set(code, { expiresAt, consumed: false });
+        return { code, expiresAt };
+    }
+    redeem(raw) {
+        const code = normalizeCode(raw);
+        const entry = this.#codes.get(code);
+        if (!entry)
+            return 'unknown';
+        if (entry.consumed)
+            return 'consumed';
+        if (entry.expiresAt <= this.#now()) {
+            this.#codes.delete(code);
+            return 'expired';
+        }
+        entry.consumed = true;
+        return 'ok';
+    }
+    pending() {
+        this.#prune();
+        const now = this.#now();
+        return [...this.#codes.entries()]
+            .filter(([, entry]) => !entry.consumed && entry.expiresAt > now)
+            .map(([code, entry]) => ({ code, expiresAt: entry.expiresAt }));
+    }
+    #prune() {
+        const horizon = this.#now() - 60 * 60 * 1000;
+        for (const [code, entry] of this.#codes) {
+            if (entry.expiresAt < horizon)
+                this.#codes.delete(code);
+        }
+    }
+}
+//# sourceMappingURL=pairing.js.map

package/dist/core/pairing.js.map

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

package/dist/dsh/errors.d.ts

@@ -0,0 +1,3 @@
+export declare function codeOf(error: unknown): string | undefined;
+export declare function messageOf(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/dsh/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/dsh/errors.ts"],"names":[],"mappings":"AAKA,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIzD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMhD"}

package/dist/dsh/errors.js

@@ -0,0 +1,15 @@
+export function codeOf(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const { code } = error;
+    return typeof code === 'string' ? code : undefined;
+}
+export function messageOf(error) {
+    if (typeof error === 'object' && error !== null) {
+        const { message } = error;
+        if (typeof message === 'string')
+            return message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/dsh/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/dsh/errors.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAmB,CAAC;IACrC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAmB,CAAC;QACxC,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/dsh/lifecycle.d.ts

@@ -0,0 +1,37 @@
+import { type HostContext } from '../host-api.js';
+export declare function canCreateSession(ctx: HostContext): boolean;
+export declare function canArchiveSession(ctx: HostContext): boolean;
+export declare function canUnarchiveSession(ctx: HostContext): boolean;
+export type CreateResult = {
+    ok: true;
+    sessionId: string;
+} | {
+    ok: false;
+    code: 'no-service' | 'no-folder' | 'failed';
+    message: string;
+};
+export declare function createSession(ctx: HostContext, request: {
+    workspaceId: string;
+}): Promise<CreateResult>;
+export type UnarchiveResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'no-service' | 'not-found' | 'failed';
+    message: string;
+};
+export declare function unarchiveSession(ctx: HostContext, request: {
+    sessionId: string;
+}): Promise<UnarchiveResult>;
+export type ArchiveResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'no-service' | 'active' | 'not-found' | 'failed';
+    message: string;
+};
+export declare function archiveSession(ctx: HostContext, request: {
+    sessionId: string;
+    stopActivity?: boolean;
+}): Promise<ArchiveResult>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/dsh/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/dsh/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAa3D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAO1D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAO3D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAO7D;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,YAAY,CAAC,CAoBvB;AAED,MAAM,MAAM,eAAe,GACzB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7F,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,wBAAsB,cAAc,CAClC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD,OAAO,CAAC,aAAa,CAAC,CA0BxB"}

package/dist/dsh/lifecycle.js

@@ -0,0 +1,95 @@
+import { service } from '../host-api.js';
+import { codeOf, messageOf } from './errors.js';
+export function canCreateSession(ctx) {
+    try {
+        const controller = service(ctx, 'sessionController');
+        return typeof controller?.create === 'function';
+    }
+    catch {
+        return false;
+    }
+}
+export function canArchiveSession(ctx) {
+    try {
+        const controller = service(ctx, 'workspaceController');
+        return typeof controller?.archiveSession === 'function';
+    }
+    catch {
+        return false;
+    }
+}
+export function canUnarchiveSession(ctx) {
+    try {
+        const controller = service(ctx, 'workspaceController');
+        return typeof controller?.unarchiveSession === 'function';
+    }
+    catch {
+        return false;
+    }
+}
+export async function createSession(ctx, request) {
+    const controller = service(ctx, 'sessionController');
+    if (!controller || typeof controller.create !== 'function') {
+        return { ok: false, code: 'no-service', message: 'This host cannot create sessions.' };
+    }
+    try {
+        const created = await controller.create({ workspaceId: request.workspaceId });
+        const sessionId = created?.sessionId;
+        if (typeof sessionId !== 'string' || !sessionId) {
+            return { ok: false, code: 'failed', message: 'The host did not return a session.' };
+        }
+        return { ok: true, sessionId };
+    }
+    catch (error) {
+        const code = codeOf(error);
+        if (code === 'workspace/not-found' || code === 'session/not-found') {
+            return { ok: false, code: 'no-folder', message: 'That folder no longer exists.' };
+        }
+        return { ok: false, code: 'failed', message: messageOf(error) };
+    }
+}
+export async function unarchiveSession(ctx, request) {
+    const controller = service(ctx, 'workspaceController');
+    if (!controller || typeof controller.unarchiveSession !== 'function') {
+        return { ok: false, code: 'no-service', message: 'This host cannot unarchive sessions.' };
+    }
+    try {
+        await controller.unarchiveSession({ sessionId: request.sessionId });
+        return { ok: true };
+    }
+    catch (error) {
+        const code = codeOf(error);
+        if (code === 'session/not-found' || code === 'workspace/not-found') {
+            return { ok: false, code: 'not-found', message: 'That session no longer exists.' };
+        }
+        return { ok: false, code: 'failed', message: messageOf(error) };
+    }
+}
+export async function archiveSession(ctx, request) {
+    const controller = service(ctx, 'workspaceController');
+    if (!controller || typeof controller.archiveSession !== 'function') {
+        return { ok: false, code: 'no-service', message: 'This host cannot archive sessions.' };
+    }
+    try {
+        await controller.archiveSession({
+            sessionId: request.sessionId,
+            ...(request.stopActivity === true ? { stopActivity: true } : {}),
+        });
+        return { ok: true };
+    }
+    catch (error) {
+        const code = codeOf(error);
+        if (code === 'workspace/session-active') {
+            return {
+                ok: false,
+                code: 'active',
+                message: 'That session has work running. Stop it first.',
+            };
+        }
+        if (code === 'session/not-found' || code === 'workspace/not-found') {
+            return { ok: false, code: 'not-found', message: 'That session no longer exists.' };
+        }
+        return { ok: false, code: 'failed', message: messageOf(error) };
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/dsh/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/dsh/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAoB,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAWhD,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAA6B,GAAG,EAAE,mBAAmB,CAAC,CAAC;QACjF,OAAO,OAAO,UAAU,EAAE,MAAM,KAAK,UAAU,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAgB;IAChD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAsB,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAC5E,OAAO,OAAO,UAAU,EAAE,cAAc,KAAK,UAAU,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAClD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,OAAO,CAAsB,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAC5E,OAAO,OAAO,UAAU,EAAE,gBAAgB,KAAK,UAAU,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAgB,EAChB,OAAgC;IAEhC,MAAM,UAAU,GAAG,OAAO,CAA6B,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACjF,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC3D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;IACzF,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;QACrC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;QACtF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,qBAAqB,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;QACpF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAKD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAgB,EAChB,OAA8B;IAE9B,MAAM,UAAU,GAAG,OAAO,CAAsB,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC5E,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACrE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACpE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;QACrF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAgB,EAChB,OAAsD;IAEtD,MAAM,UAAU,GAAG,OAAO,CAAsB,GAAG,EAAE,qBAAqB,CAAC,CAAC;IAC5E,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAC1F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,cAAc,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,0BAA0B,EAAE,CAAC;YACxC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,+CAA+C;aACzD,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;QACrF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/dsh/models.d.ts

@@ -0,0 +1,39 @@
+import { type HostContext } from '../host-api.js';
+import type { ModelCatalog, ModelSelection } from '@deepseekharness-mobile/protocol';
+interface CatalogPayload {
+    default?: unknown;
+    groups?: unknown;
+    failures?: unknown;
+}
+export interface ModelController {
+    modelCatalog?: () => Promise<CatalogPayload>;
+    selectModel?: (request: {
+        sessionId: string;
+        provider: string;
+        model: string;
+        reasoningEffort?: string;
+    }) => Promise<{
+        selected?: unknown;
+    }>;
+}
+export declare function selectionOf(value: unknown): ModelSelection | undefined;
+export declare function toCatalog(payload: unknown): ModelCatalog;
+export declare function canListModels(ctx: HostContext): boolean;
+export declare function canSelectModel(ctx: HostContext): boolean;
+export declare function listModels(ctx: HostContext): Promise<ModelCatalog>;
+export type SelectResult = {
+    ok: true;
+    selection: ModelSelection;
+} | {
+    ok: false;
+    code: 'no-service' | 'unavailable' | 'not-found' | 'failed';
+    message: string;
+};
+export declare function selectModel(ctx: HostContext, request: {
+    sessionId: string;
+    provider: string;
+    model: string;
+    reasoningEffort?: string;
+}): Promise<SelectResult>;
+export {};
+//# sourceMappingURL=models.d.ts.map

package/dist/dsh/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/dsh/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EACV,YAAY,EAIZ,cAAc,EACf,MAAM,kCAAkC,CAAC;AAgB1C,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,KAAK,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACvC;AAMD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CActE;AA6ED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAmBxD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAMvD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAMxD;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAcxE;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,cAAc,CAAA;CAAE,GACvC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,wBAAsB,WAAW,CAC/B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACxF,OAAO,CAAC,YAAY,CAAC,CA8BvB"}