sqs-dsh-better-input 0.1.0

package/lib/remote.js

@@ -0,0 +1,226 @@
+import { n as PACKAGE_NAME } from "./identity-CzaR1Taa.js";
+//#region src/remote.ts
+/**
+* Build one strict codec for the CLIENT face.
+*
+* The client face exists only to describe the wire shape to
+* `ctx.remote.$mount`; the actual byte validation happens on the Host. This is
+* not an assumption — it is how dsh 0.1.7 is wired:
+*
+*   - `@deepseek-ai/dsh-api-gateway/lib/index.js` (Host) is the ONLY place that
+*     runs `codec.create().parse(value)`. Validation lives in `decode()`.
+*   - `…/lib/client.js` contains ZERO `.create()` calls. Its `$mount` path only
+*     calls `requireStrictCodecs`, which inspects `codec.mode === 'strict'` and
+*     never reads `typeSymbol` or invokes the factory. `prepareInvocation()`
+*     forwards raw argument values straight to the RPC carrier.
+*
+* So materializing a real schema in the browser is pure dead weight: it pulls
+* all of zod (~280 KB) into `lib/client.js` for a factory that is never called.
+* The `create()` here is therefore lazy AND schema-free — it never imports zod.
+*
+* The eager `import { …Schema } from './remote-contract.js'` that used to sit
+* at the top of this file was the single value-reachability edge that dragged
+* zod into the browser bundle, because `src/client/index.ts` needs
+* `TYPERT_REMOTE` as a value.
+*
+* The placeholder satisfies `TypertSchema` ({ parse(value) }) structurally, so
+* the client face still typechecks. It is unreachable at runtime; if a future
+* dsh ever validates on the client, `parse` throws loudly instead of silently
+* accepting bad bytes. The Host manifest in `typert.ts` keeps the real zod
+* schemas.
+*/
+function codec(typeSymbol) {
+	return {
+		mode: "strict",
+		typeSymbol,
+		create: () => ({ parse(value) {
+			throw new Error(`sqs-dsh-better-input: client-face codec ${typeSymbol} was materialized. The client must never validate wire bytes (the Host does). If this fires, the client-face descriptor is being used for validation it should not own.`);
+		} })
+	};
+}
+/** Type symbol for one of this plugin's own wire types. */
+const symbol = (name) => `${PACKAGE_NAME}#${name}`;
+/** The client-face Typert manifest; mirrors the Host face in `typert.ts`. */
+const TYPERT_REMOTE = {
+	package: PACKAGE_NAME,
+	descriptors: [
+		{
+			id: `${PACKAGE_NAME}#betterInput/getSettings`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "getSettings",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: codec(symbol("BetterInputSettingsView"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/updateSettings`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "updateSettings",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "patch",
+				wire: "patch",
+				source: "json",
+				codec: codec(symbol("BetterInputSettingsPatch"))
+			}],
+			cancellation: { parameter: "signal" },
+			result: codec(symbol("BetterInputSettingsView"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/listRoutes`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "listRoutes",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: codec(symbol("PolishRoute[]"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/resolveModelEfforts`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "resolveModelEfforts",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "provider",
+				wire: "provider",
+				source: "json",
+				codec: codec("string")
+			}, {
+				name: "model",
+				wire: "model",
+				source: "json",
+				codec: codec("string")
+			}],
+			result: codec(symbol("ResolveModelEffortsResult"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/getAbout`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "getAbout",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: codec(symbol("AboutInfo"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/checkForUpdate`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "checkForUpdate",
+			invocation: { kind: "direct" },
+			parameters: [],
+			cancellation: { parameter: "signal" },
+			result: codec(symbol("UpdateCheckResult"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/polish`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "polish",
+			invocation: { kind: "direct" },
+			parameters: [
+				{
+					name: "transcript",
+					wire: "transcript",
+					source: "json",
+					codec: codec("string")
+				},
+				{
+					name: "provider",
+					wire: "provider",
+					source: "json",
+					codec: codec("string")
+				},
+				{
+					name: "model",
+					wire: "model",
+					source: "json",
+					codec: codec("string")
+				}
+			],
+			cancellation: { parameter: "signal" },
+			result: codec("string")
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/optimize`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "optimize",
+			invocation: { kind: "direct" },
+			parameters: [
+				{
+					name: "text",
+					wire: "text",
+					source: "json",
+					codec: codec("string")
+				},
+				{
+					name: "provider",
+					wire: "provider",
+					source: "json",
+					codec: codec("string")
+				},
+				{
+					name: "model",
+					wire: "model",
+					source: "json",
+					codec: codec("string")
+				},
+				{
+					name: "context",
+					wire: "context",
+					source: "json",
+					codec: codec("string")
+				}
+			],
+			cancellation: { parameter: "signal" },
+			result: codec("string")
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/templatesList`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "templatesList",
+			invocation: { kind: "direct" },
+			parameters: [],
+			result: codec(symbol("TemplateListResult"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/templatesSave`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "templatesSave",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "template",
+				wire: "template",
+				source: "json",
+				codec: codec(symbol("TemplateInput"))
+			}],
+			cancellation: { parameter: "signal" },
+			result: codec(symbol("TemplateSaveResult"))
+		},
+		{
+			id: `${PACKAGE_NAME}#betterInput/templatesRemove`,
+			service: "BetterInputPolish",
+			namespace: "betterInput",
+			method: "templatesRemove",
+			invocation: { kind: "direct" },
+			parameters: [{
+				name: "id",
+				wire: "id",
+				source: "json",
+				codec: codec("string")
+			}],
+			cancellation: { parameter: "signal" },
+			result: codec(symbol("TemplateRemoveResult"))
+		}
+	]
+};
+//#endregion
+export { TYPERT_REMOTE, TYPERT_REMOTE as default };
+
+//# sourceMappingURL=remote.js.map

package/lib/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","names":[],"sources":["../src/remote.ts"],"sourcesContent":["import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol'\nimport type { ClientRemote } from '@deepseek-ai/dsh-api-remotes/client'\nimport type { AboutInfoWire, BetterInputSettingsPatch, BetterInputSettingsView, PolishRoute, ReasoningEffortInfo, TemplateInputWire, TemplateWire, UpdateCheckResultWire } from './remote-contract.js'\nimport { PACKAGE_NAME } from './identity.js'\n\nexport type BetterInputRemote = ClientRemote['betterInput']\n\ndeclare module '@deepseek-ai/dsh-typert-protocol' {\n  interface TypertRemoteNamespace$betterInput {\n    getSettings: () => Promise<RemoteResult<BetterInputSettingsView>>\n    updateSettings: (patch: BetterInputSettingsPatch, signal?: AbortSignal) => Promise<RemoteResult<BetterInputSettingsView>>\n    listRoutes: () => Promise<RemoteResult<PolishRoute[]>>\n    resolveModelEfforts: (provider: string, model: string) => Promise<RemoteResult<{ efforts: readonly ReasoningEffortInfo[]; defaultEffort?: string }>>\n    getAbout: () => Promise<RemoteResult<AboutInfoWire>>\n    checkForUpdate: (signal?: AbortSignal) => Promise<RemoteResult<UpdateCheckResultWire>>\n    polish: (transcript: string, provider: string, model: string, signal?: AbortSignal) => Promise<RemoteResult<string>>\n    optimize: (text: string, provider: string, model: string, context: string, signal?: AbortSignal) => Promise<RemoteResult<string>>\n    templatesList: () => Promise<RemoteResult<{ templates: TemplateWire[] }>>\n    templatesSave: (template: TemplateInputWire, signal?: AbortSignal) => Promise<RemoteResult<{ template: TemplateWire }>>\n    templatesRemove: (id: string, signal?: AbortSignal) => Promise<RemoteResult<{ removed: boolean }>>\n  }\n\n  interface TypertRemoteMap {\n    'betterInput/getSettings': () => Promise<RemoteResult<BetterInputSettingsView>>\n    'betterInput/updateSettings': (patch: BetterInputSettingsPatch, signal?: AbortSignal) => Promise<RemoteResult<BetterInputSettingsView>>\n    'betterInput/listRoutes': () => Promise<RemoteResult<PolishRoute[]>>\n    'betterInput/resolveModelEfforts': (provider: string, model: string) => Promise<RemoteResult<{ efforts: readonly ReasoningEffortInfo[]; defaultEffort?: string }>>\n    'betterInput/getAbout': () => Promise<RemoteResult<AboutInfoWire>>\n    'betterInput/checkForUpdate': (signal?: AbortSignal) => Promise<RemoteResult<UpdateCheckResultWire>>\n    'betterInput/polish': (transcript: string, provider: string, model: string, signal?: AbortSignal) => Promise<RemoteResult<string>>\n    'betterInput/optimize': (text: string, provider: string, model: string, context: string, signal?: AbortSignal) => Promise<RemoteResult<string>>\n    'betterInput/templatesList': () => Promise<RemoteResult<{ templates: TemplateWire[] }>>\n    'betterInput/templatesSave': (template: TemplateInputWire, signal?: AbortSignal) => Promise<RemoteResult<{ template: TemplateWire }>>\n    'betterInput/templatesRemove': (id: string, signal?: AbortSignal) => Promise<RemoteResult<{ removed: boolean }>>\n  }\n\n  interface TypertRemoteNamespaceMap {\n    betterInput: TypertRemoteNamespace$betterInput\n  }\n}\n\n/**\n * Build one strict codec for the CLIENT face.\n *\n * The client face exists only to describe the wire shape to\n * `ctx.remote.$mount`; the actual byte validation happens on the Host. This is\n * not an assumption — it is how dsh 0.1.7 is wired:\n *\n *   - `@deepseek-ai/dsh-api-gateway/lib/index.js` (Host) is the ONLY place that\n *     runs `codec.create().parse(value)`. Validation lives in `decode()`.\n *   - `…/lib/client.js` contains ZERO `.create()` calls. Its `$mount` path only\n *     calls `requireStrictCodecs`, which inspects `codec.mode === 'strict'` and\n *     never reads `typeSymbol` or invokes the factory. `prepareInvocation()`\n *     forwards raw argument values straight to the RPC carrier.\n *\n * So materializing a real schema in the browser is pure dead weight: it pulls\n * all of zod (~280 KB) into `lib/client.js` for a factory that is never called.\n * The `create()` here is therefore lazy AND schema-free — it never imports zod.\n *\n * The eager `import { …Schema } from './remote-contract.js'` that used to sit\n * at the top of this file was the single value-reachability edge that dragged\n * zod into the browser bundle, because `src/client/index.ts` needs\n * `TYPERT_REMOTE` as a value.\n *\n * The placeholder satisfies `TypertSchema` ({ parse(value) }) structurally, so\n * the client face still typechecks. It is unreachable at runtime; if a future\n * dsh ever validates on the client, `parse` throws loudly instead of silently\n * accepting bad bytes. The Host manifest in `typert.ts` keeps the real zod\n * schemas.\n */\nfunction codec(typeSymbol: string) {\n  return {\n    mode: 'strict' as const,\n    typeSymbol,\n    create: () => ({\n      parse(value: unknown): unknown {\n        throw new Error(\n          `sqs-dsh-better-input: client-face codec ${typeSymbol} was materialized. ` +\n          'The client must never validate wire bytes (the Host does). ' +\n          'If this fires, the client-face descriptor is being used for validation it should not own.'\n        )\n      }\n    })\n  }\n}\n\n/** Type symbol for one of this plugin's own wire types. */\nconst symbol = (name: string): string => `${PACKAGE_NAME}#${name}`\n\n/** The client-face Typert manifest; mirrors the Host face in `typert.ts`. */\nexport const TYPERT_REMOTE: TypertRemoteContribution = {\n  package: PACKAGE_NAME,\n  descriptors: [\n    {\n      id: `${PACKAGE_NAME}#betterInput/getSettings`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'getSettings',\n      invocation: { kind: 'direct' },\n      parameters: [],\n      result: codec(symbol('BetterInputSettingsView'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/updateSettings`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'updateSettings',\n      invocation: { kind: 'direct' },\n      parameters: [{\n        name: 'patch',\n        wire: 'patch',\n        source: 'json',\n        codec: codec(symbol('BetterInputSettingsPatch'))\n      }],\n      cancellation: { parameter: 'signal' },\n      result: codec(symbol('BetterInputSettingsView'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/listRoutes`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'listRoutes',\n      invocation: { kind: 'direct' },\n      parameters: [],\n      result: codec(symbol('PolishRoute[]'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/resolveModelEfforts`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'resolveModelEfforts',\n      invocation: { kind: 'direct' },\n      parameters: [\n        { name: 'provider', wire: 'provider', source: 'json', codec: codec('string') },\n        { name: 'model', wire: 'model', source: 'json', codec: codec('string') }\n      ],\n      result: codec(symbol('ResolveModelEffortsResult'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/getAbout`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'getAbout',\n      invocation: { kind: 'direct' },\n      parameters: [],\n      result: codec(symbol('AboutInfo'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/checkForUpdate`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'checkForUpdate',\n      invocation: { kind: 'direct' },\n      parameters: [],\n      cancellation: { parameter: 'signal' },\n      result: codec(symbol('UpdateCheckResult'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/polish`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'polish',\n      invocation: { kind: 'direct' },\n      parameters: [\n        { name: 'transcript', wire: 'transcript', source: 'json', codec: codec('string') },\n        { name: 'provider', wire: 'provider', source: 'json', codec: codec('string') },\n        { name: 'model', wire: 'model', source: 'json', codec: codec('string') }\n      ],\n      cancellation: { parameter: 'signal' },\n      result: codec('string')\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/optimize`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'optimize',\n      invocation: { kind: 'direct' },\n      parameters: [\n        { name: 'text', wire: 'text', source: 'json', codec: codec('string') },\n        { name: 'provider', wire: 'provider', source: 'json', codec: codec('string') },\n        { name: 'model', wire: 'model', source: 'json', codec: codec('string') },\n        { name: 'context', wire: 'context', source: 'json', codec: codec('string') }\n      ],\n      cancellation: { parameter: 'signal' },\n      result: codec('string')\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/templatesList`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'templatesList',\n      invocation: { kind: 'direct' },\n      parameters: [],\n      result: codec(symbol('TemplateListResult'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/templatesSave`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'templatesSave',\n      invocation: { kind: 'direct' },\n      parameters: [{\n        name: 'template',\n        wire: 'template',\n        source: 'json',\n        codec: codec(symbol('TemplateInput'))\n      }],\n      cancellation: { parameter: 'signal' },\n      result: codec(symbol('TemplateSaveResult'))\n    },\n    {\n      id: `${PACKAGE_NAME}#betterInput/templatesRemove`,\n      service: 'BetterInputPolish',\n      namespace: 'betterInput',\n      method: 'templatesRemove',\n      invocation: { kind: 'direct' },\n      parameters: [{ name: 'id', wire: 'id', source: 'json', codec: codec('string') }],\n      cancellation: { parameter: 'signal' },\n      result: codec(symbol('TemplateRemoveResult'))\n    }\n  ]\n}\n\nexport default TYPERT_REMOTE\n"],"mappings":"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"}

package/lib/settings/store.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Host-side JSON file storage for the plugin's own settings.
+ *
+ * Location: `~/.dsh/sqs-dsh-better-input/settings.json`.
+ *
+ * dsh 0.1.7 replaced the old per-plugin `settings.register(namespace, schema)`
+ * API with a Loader-entry configuration model (`SettingsForms`, addressed by
+ * profile entry id with revision CAS). That model is built for schema-declared
+ * plugin *Config* in the composition, not for a plugin's own runtime knobs, and
+ * it changes shape between releases.
+ *
+ * This plugin therefore owns its settings in a plain JSON document, exactly like
+ * the template library. That keeps it independent of the settings API churn,
+ * keeps writes atomic, and keeps the settings page a normal `settings.section`
+ * slot (which is unchanged in 0.1.7).
+ */
+import { type BetterInputSettings } from '../config.js';
+export declare function defaultSettingsFilePath(): string;
+/**
+ * Coerce an untrusted stored document into a complete settings object. Every
+ * field falls back to its default, so a partially written or hand-edited file
+ * still yields a usable value instead of throwing.
+ */
+export declare function normalizeSettings(raw: unknown): BetterInputSettings;
+export declare class SettingsStore {
+    private readonly filePath;
+    private cache;
+    private persistChain;
+    constructor(filePath?: string);
+    /** Read the current settings, falling back to defaults when absent/corrupt. */
+    load(): Promise<BetterInputSettings>;
+    /**
+     * Merge a patch into the stored settings and persist. Validates the merged
+     * document first, so an out-of-range value never reaches disk.
+     */
+    merge(patch: Partial<BetterInputSettings>): Promise<BetterInputSettings>;
+    private quarantineCorruptFile;
+    private persist;
+    /** Write via temp file + rename so a crash never leaves a half-written file. */
+    private writeAtomic;
+}

package/lib/templates/model.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Prompt template data model shared by the host store and the Typert layer.
+ * A template is a plain text snippet the user stores once and later inserts
+ * from the input box via the `/` trigger source.
+ */
+export type BetterInputTemplate = {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly content: string;
+    readonly tags: readonly string[];
+    readonly createdAt: number;
+    readonly updatedAt: number;
+};
+export type TemplateInput = {
+    readonly id?: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly content: string;
+    readonly tags?: readonly string[];
+};
+export declare const MAX_TEMPLATE_COUNT = 200;
+export declare const MAX_TEMPLATE_NAME_LENGTH = 60;
+export declare const MAX_TEMPLATE_DESCRIPTION_LENGTH = 200;
+export declare const MAX_TEMPLATE_CONTENT_LENGTH = 8000;
+export declare const MAX_TEMPLATE_TAGS = 8;
+export declare const MAX_TEMPLATE_TAG_LENGTH = 20;
+/** Trim, drop empties, dedupe case-insensitively, cap count and length. */
+export declare function normalizeTags(tags: readonly string[]): string[];
+export declare function validateTemplateInput(input: TemplateInput): void;

package/lib/templates/store.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Host-side JSON file storage for prompt templates.
+ *
+ * Location: `~/.dsh/sqs-dsh-better-input/templates.json`. The plugin ships as a flat
+ * bundle under node_modules, so anything stored next to the package would be
+ * wiped on update — the only durable, dependency-free location is the user's
+ * home directory (Node builtins only).
+ *
+ * Writes are serialized through a promise chain and performed atomically
+ * (temp file + rename). A corrupt file is quarantined aside once with a
+ * warning instead of failing every subsequent call.
+ */
+import { type BetterInputTemplate, type TemplateInput } from './model.js';
+export declare function defaultTemplatesFilePath(): string;
+export declare class TemplateStore {
+    private readonly filePath;
+    private cache;
+    private persistChain;
+    constructor(filePath?: string);
+    list(): Promise<readonly BetterInputTemplate[]>;
+    save(input: TemplateInput): Promise<BetterInputTemplate>;
+    remove(id: string): Promise<boolean>;
+    private load;
+    private quarantineCorruptFile;
+    private persist;
+    private writeAtomic;
+}

package/lib/typert.d.ts

@@ -0,0 +1,107 @@
+/**
+ * The Host-side Typert manifest. It must mirror `TYPERT_REMOTE` (the client
+ * face) method-for-method; a mismatch is rejected at the boundary.
+ */
+export declare const TYPERT: {
+    package: string;
+    face: string;
+    schemas: never[];
+    invocations: ({
+        id: string;
+        service: string;
+        namespace: string;
+        method: string;
+        invocation: {
+            kind: string;
+        };
+        parameters: {
+            name: string;
+            wire: string;
+            source: string;
+            codec: {
+                mode: "strict";
+                typeSymbol: string;
+                create: () => {
+                    parse(value: unknown): unknown;
+                };
+            };
+        }[];
+        cancellation: {
+            parameter: string;
+        };
+        result: {
+            mode: "strict";
+            typeSymbol: string;
+            create: () => {
+                parse(value: unknown): unknown;
+            };
+        };
+    } | {
+        id: string;
+        service: string;
+        namespace: string;
+        method: string;
+        invocation: {
+            kind: string;
+        };
+        parameters: {
+            name: string;
+            wire: string;
+            source: string;
+            codec: {
+                mode: "strict";
+                typeSymbol: string;
+                create: () => {
+                    parse(value: unknown): unknown;
+                };
+            };
+        }[];
+        result: {
+            mode: "strict";
+            typeSymbol: string;
+            create: () => {
+                parse(value: unknown): unknown;
+            };
+        };
+        cancellation?: undefined;
+    })[];
+    /**
+     * The typed-registry model block.
+     *
+     * This is REQUIRED by dsh 0.1.7's typert loader, not optional metadata:
+     * `validateTypertManifest` reads `manifest.model` and demands an object whose
+     * `services` / `events` / `objects` are arrays (see `dsh-typert-loader/lib/index.js`
+     * :89-92, and `requireObject` at :119-122). A missing `model` fails the whole
+     * entry with "typert-loader: <pkg> TYPERT.model must be an object", the entry
+     * never activates, and the browser web boot then refuses to render the UI.
+     *
+     * Removing the file-input / OCR feature dropped this block by accident in
+     * 0.1.0-0.1.2 (`convertFile` and `ConvertFileResult` were the only intended
+     * deletions). Keep `model` in sync with `invocations` above and with the
+     * service surface in `polish/service.ts`.
+     */
+    model: {
+        services: {
+            description: string;
+            summary: string;
+            tags: never[];
+            jsDoc: string;
+            key: string;
+            exportName: string;
+            members: {
+                kind: string;
+                name: string;
+                signature: string;
+                summary: string;
+                jsDoc: string;
+            }[];
+            types: {
+                name: string;
+                declaration: string;
+            }[];
+        }[];
+        events: never[];
+        objects: never[];
+    };
+};
+export default TYPERT;