aicodeman 1.47.0 → 1.49.0

package/dist/custom-model-injection.js

@@ -69,12 +69,20 @@ contextLength) {
             return result;
         }
         case 'configContentEnv': {
-            const content = renderConfigContent(cap.template, endpoint, modelId, apiKey);
+            const content = renderConfigContent(cap.template, endpoint, modelId, apiKey, contextLength);
             return withLaunchModel({ kind: 'env', envOverrides: { [cap.envVar]: content } }, cap.launchModel, modelId);
         }
         case 'configDir': {
-            const { content, extraEnv } = renderConfigFile(cap.template, endpoint, modelId, apiKey);
-            return withLaunchModel({ kind: 'configDir', dirEnvVar: cap.dirEnvVar, files: [{ relPath: cap.fileName, content }], extraEnv }, cap.launchModel, modelId);
+            const { content, extraEnv } = renderConfigFile(cap.template, endpoint, modelId, apiKey, contextLength);
+            return withLaunchModel({
+                kind: 'configDir',
+                dirEnvVar: cap.dirEnvVar,
+                files: [{ relPath: cap.fileName, content }],
+                extraEnv,
+                ...(cap.linkFromRealHome ? { linkFromRealHome: cap.linkFromRealHome } : {}),
+                ...(cap.linkFromRealHomeDirs ? { linkFromRealHomeDirs: cap.linkFromRealHomeDirs } : {}),
+                ...(cap.realHomeFallback ? { realHomeFallback: cap.realHomeFallback } : {}),
+            }, cap.launchModel, modelId);
         }
         case 'unsupported':
             return { kind: 'unsupported' };
@@ -86,28 +94,96 @@ function withLaunchModel(result, template, modelId) {
         return result;
     return { ...result, launchModel: template.split('{modelId}').join(modelId) };
 }
-function renderConfigContent(template, endpoint, modelId, apiKey) {
+/**
+ * One quarter of the window is held back for the reply, capped at 8192 tokens (a small local
+ * model's window must not lose a disproportionate slice to the reservation). Returns undefined
+ * for an unknown or non-finite size: opencode then keeps its own default guess, which is the
+ * pre-fix behaviour; never invent a limit here.
+ */
+function opencodeModelLimit(contextLength) {
+    if (contextLength === undefined || !Number.isFinite(contextLength))
+        return undefined;
+    const total = Math.trunc(contextLength);
+    if (total <= 0)
+        return undefined;
+    const output = Math.max(1, Math.min(8192, Math.floor(total / 4)));
+    // `limit.context` is the FULL window as far as opencode is concerned: it reserves for
+    // the reply itself, so the discovered total is passed through, never a shrunk figure.
+    return { context: total, output };
+}
+function renderConfigContent(template, endpoint, modelId, apiKey, contextLength) {
     switch (template) {
-        case 'opencode-json':
+        case 'opencode-json': {
+            // `limit` carries the discovered context window (issue #749): without it opencode assumes
+            // a large default window for an unrecognized model id and eventually overflows a much
+            // smaller local server. `context` is the FULL window and opencode reserves for the reply
+            // inside it itself, so `opencodeModelLimit` passes the real total through and only
+            // `output` gets the capped reservation.
+            const limit = opencodeModelLimit(contextLength);
             return JSON.stringify({
                 $schema: 'https://opencode.ai/config.json',
                 provider: {
                     custom: {
                         options: { baseURL: withV1Suffix(endpoint.baseUrl), apiKey },
-                        models: { [modelId]: {} },
+                        models: { [modelId]: limit ? { limit } : {} },
                     },
                 },
                 model: `custom/${modelId}`,
             });
+        }
     }
 }
-const CODEX_API_KEY_ENV_VAR = 'CODEMAN_CUSTOM_MODEL_API_KEY';
+/** The DEDICATED env var carrying a custom endpoint's API key for config-file recipes that
+ *  reference keys by name (codex's `env_key`, deepseek's `apiKeyEnv`). Never a CLI-native
+ *  name: dsh's own `llm-deepseek`/`web-search-deepseek` rows read `DEEPSEEK_API_KEY` too,
+ *  so an in-session `/model` switch back to `deepseek-official` (or a profile with web
+ *  search on) would otherwise send the custom endpoint's key to api.deepseek.com. Both
+ *  entries list it in `privilegedEnvKeys` (stock.ts) like each other's redirect vars.
+ */
+const CUSTOM_MODEL_API_KEY_ENV_VAR = 'CODEMAN_CUSTOM_MODEL_API_KEY';
 /** The `[model.<name>]` block name grok's config.toml uses for the injected model — also
  *  what `-m <name>` in the standalone script's ONE_SHOT argv must reference to select it. */
 export const GROK_CUSTOM_MODEL_NAME = 'codeman-custom';
-function renderConfigFile(template, endpoint, modelId, apiKey) {
+function renderConfigFile(template, endpoint, modelId, apiKey, contextLength) {
     const baseUrl = withV1Suffix(endpoint.baseUrl);
     switch (template) {
+        case 'deepseek-patch-json': {
+            const route = { provider: 'codeman-custom', model: modelId };
+            return {
+                content: JSON.stringify([
+                    {
+                        id: 'llm-pi-ai',
+                        name: '@deepseek-ai/dsh-llm-pi-ai',
+                        config: {
+                            providers: {
+                                'codeman-custom': {
+                                    // By NAME only (never the literal key, see CUSTOM_MODEL_API_KEY_ENV_VAR).
+                                    apiKeyEnv: CUSTOM_MODEL_API_KEY_ENV_VAR,
+                                    api: 'openai-completions',
+                                    baseURL: baseUrl,
+                                    models: [
+                                        {
+                                            id: modelId,
+                                            name: modelId,
+                                            ...(contextLength !== undefined && Number.isFinite(contextLength) && contextLength > 0
+                                                ? {
+                                                    contextWindow: Math.trunc(contextLength),
+                                                    // A quarter of the window keeps the reply inside the prompt's share; 8192 caps it on a large window.
+                                                    maxTokens: Math.max(1, Math.min(8192, Math.floor(contextLength / 4))),
+                                                }
+                                                : {}),
+                                        },
+                                    ],
+                                },
+                            },
+                        },
+                    },
+                    { id: 'dsh-tui', name: '@deepseek-harness-tui/dsh-tui', config: route },
+                    { id: 'agent-default-model', name: '@deepseek-ai/dsh-agent-default-model', config: route },
+                ], null, 2),
+                extraEnv: { [CUSTOM_MODEL_API_KEY_ENV_VAR]: apiKey },
+            };
+        }
         case 'codex-toml': {
             // Verified against real codex (>= Feb 2026): `model` is a top-level STRING, never
             // a `[model].default` table — codex rejects that with "invalid type: map, expected
@@ -126,15 +202,21 @@ function renderConfigFile(template, endpoint, modelId, apiKey) {
             const content = [
                 `model = ${quoted(modelId)}`,
                 `model_provider = "custom"`,
+                ...(contextLength !== undefined && Number.isFinite(contextLength) && contextLength > 0
+                    ? [
+                        `model_context_window = ${Math.trunc(contextLength)}`,
+                        `model_auto_compact_token_limit = ${Math.max(1, Math.floor(contextLength * 0.75))}`,
+                    ]
+                    : []),
                 '',
                 '[model_providers.custom]',
                 `name = "Custom Endpoint"`,
                 `base_url = ${quoted(baseUrl)}`,
-                `env_key = ${quoted(CODEX_API_KEY_ENV_VAR)}`,
+                `env_key = ${quoted(CUSTOM_MODEL_API_KEY_ENV_VAR)}`,
                 `wire_api = "responses"`,
                 '',
             ].join('\n');
-            return { content, extraEnv: { [CODEX_API_KEY_ENV_VAR]: apiKey } };
+            return { content, extraEnv: { [CUSTOM_MODEL_API_KEY_ENV_VAR]: apiKey } };
         }
         case 'pi-models-json':
             // Verified against pi's OWN bundled docs (models.md): `models` is an ARRAY of

package/dist/custom-model-injection.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-model-injection.js","sourceRoot":"","sources":["../src/custom-model-injection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AA+DH,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C,yHAAyH;AACzH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC;AAC3D,CAAC;AAED,iIAAiI;AACjI,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAqC,EACrC,QAA6B,EAC7B,OAAe;AACf,uFAAuF;AACvF,aAAsB;IAEtB,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,oBAAoB,CAAC;IACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;IAE1D,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,YAAY,GAA2B;gBAC3C,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO;gBACxF,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM;aACxB,CAAC;YACF,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,SAAS;gBAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;YACvE,IAAI,GAAG,CAAC,gBAAgB,IAAI,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC1F,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;YACzE,CAAC;YACD,IAAI,MAAM,GAAiB,eAAe,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACpG,IAAI,GAAG,CAAC,YAAY;gBAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC;YAC7E,IAAI,GAAG,CAAC,eAAe;gBAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;YAC9F,IAAI,GAAG,CAAC,mBAAmB;gBAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;YAC/E,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7E,OAAO,eAAe,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC7G,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACxF,OAAO,eAAe,CACpB,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EACtG,GAAG,CAAC,WAAW,EACf,OAAO,CACR,CAAC;QACJ,CAAC;QAED,KAAK,aAAa;YAChB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,SAAS,eAAe,CACtB,MAAS,EACT,QAA4B,EAC5B,OAAe;IAEf,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC7B,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAyB,EACzB,QAA6B,EAC7B,OAAe,EACf,MAAc;IAEd,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,eAAe;YAClB,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,iCAAiC;gBAC1C,QAAQ,EAAE;oBACR,MAAM,EAAE;wBACN,OAAO,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE;wBAC5D,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE;qBAC1B;iBACF;gBACD,KAAK,EAAE,UAAU,OAAO,EAAE;aAC3B,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,MAAM,qBAAqB,GAAG,8BAA8B,CAAC;AAE7D;6FAC6F;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AAEvD,SAAS,gBAAgB,CACvB,QAA0E,EAC1E,QAA6B,EAC7B,OAAe,EACf,MAAc;IAEd,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,kFAAkF;YAClF,mFAAmF;YACnF,qFAAqF;YACrF,mFAAmF;YACnF,oFAAoF;YACpF,gFAAgF;YAChF,gFAAgF;YAChF,gFAAgF;YAChF,gFAAgF;YAChF,0EAA0E;YAC1E,mFAAmF;YACnF,iFAAiF;YACjF,0DAA0D;YAC1D,sEAAsE;YACtE,MAAM,OAAO,GAAG;gBACd,WAAW,MAAM,CAAC,OAAO,CAAC,EAAE;gBAC5B,2BAA2B;gBAC3B,EAAE;gBACF,0BAA0B;gBAC1B,0BAA0B;gBAC1B,cAAc,MAAM,CAAC,OAAO,CAAC,EAAE;gBAC/B,aAAa,MAAM,CAAC,qBAAqB,CAAC,EAAE;gBAC5C,wBAAwB;gBACxB,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QACpE,CAAC;QACD,KAAK,gBAAgB;YACnB,8EAA8E;YAC9E,kFAAkF;YAClF,oFAAoF;YACpF,+EAA+E;YAC/E,iFAAiF;YACjF,oFAAoF;YACpF,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB;oBACE,SAAS,EAAE;wBACT,MAAM,EAAE;4BACN,OAAO;4BACP,MAAM;4BACN,GAAG,EAAE,oBAAoB;4BACzB,UAAU,EAAE,IAAI;4BAChB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;yBAC1B;qBACF;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF,CAAC;QACJ,KAAK,gBAAgB;YACnB,2EAA2E;YAC3E,gFAAgF;YAChF,6EAA6E;YAC7E,6EAA6E;YAC7E,8EAA8E;YAC9E,+EAA+E;YAC/E,OAAO;gBACL,OAAO,EAAE,uCAAuC,MAAM,CAAC,OAAO,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,iFAAiF,MAAM,CAAC,OAAO,CAAC,IAAI;aACnM,CAAC;QACJ,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,0EAA0E;YAC1E,gFAAgF;YAChF,gFAAgF;YAChF,8EAA8E;YAC9E,6EAA6E;YAC7E,iFAAiF;YACjF,8EAA8E;YAC9E,MAAM,OAAO,GAAG;gBACd,UAAU,sBAAsB,GAAG;gBACnC,WAAW,MAAM,CAAC,OAAO,CAAC,EAAE;gBAC5B,cAAc,MAAM,CAAC,OAAO,CAAC,EAAE;gBAC/B,0BAA0B;gBAC1B,yBAAyB;gBACzB,kCAAkC;gBAClC,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"custom-model-injection.js","sourceRoot":"","sources":["../src/custom-model-injection.ts"],"names":[],"mappings":"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"}

package/dist/discord-bridge.d.ts

@@ -0,0 +1,338 @@
+/**
+ * @fileoverview Two-way Discord bridge: one thread per tab, alerts out, replies typed back in.
+ *
+ * Split like webhook-notify.ts, so the parts that matter are testable without a network:
+ *   - pure: `sanitiseReply`, `threadNameFor`, `buildPost`, `discordConfigProblem`, `maskToken`
+ *   - store: `~/.codeman/discord.json` (bot token, 0600 via tmp+rename) and
+ *     `~/.codeman/discord-bridge.json` (sessionId -> threadId, not secret)
+ *   - IO: `DiscordApi` (REST, injected fetch), `DiscordGateway` (inbound WebSocket, injected
+ *     socket factory) and `DiscordBridge` (the rules that tie them to sessions)
+ *
+ * Rules the code keeps and the tests pin:
+ *   - The bot token lives only in `discord.json`; it is never returned, logged, or put in an error.
+ *   - Only messages from `allowedUserIds`, in `guildId`, inside a thread this bridge created, are
+ *     acted on. Everything else is dropped without being read further.
+ *   - A reply becomes one printable line plus Enter. Embedded newlines would submit early. A lone digit
+ *     while a permission or question is pending goes as the key alone (see onGatewayMessage).
+ *   - Posts never ping unless `pingMode` says so, and then only the allowlisted user ids.
+ *   - A Discord outage or a bad token never reaches a session: every IO path catches and backs off.
+ *
+ * @module discord-bridge
+ */
+import { type WebhookUrgency } from './types/push.js';
+import { type DiscordConfig, type DiscordGatewayState, type DiscordPingMode, type DiscordResult } from './types/discord.js';
+/** Longest reply typed into a session; Discord allows 2000, a CLI prompt rarely needs more than this. */
+export declare const MAX_REPLY_CHARS = 1000;
+export declare const DEFAULT_DISCORD_CONFIG: DiscordConfig;
+export interface DiscordMessage {
+    event: string;
+    title: string;
+    body: string;
+    urgency: WebhookUrgency;
+    sessionId?: string;
+    sessionName?: string;
+    /** The tail of what the CLI last printed, so the reader can see what it is asking. */
+    tail?: string | (() => string);
+    /**
+     * The CLI's whole last message, read from its transcript. When it yields text the post carries that
+     * (split over as many posts as it needs, markdown kept) instead of the screen tail.
+     */
+    fullText?: () => Promise<{
+        text: string;
+        version?: string;
+    } | undefined>;
+    host?: string;
+    /** A file to upload with the post (already read and size-checked by the caller). */
+    file?: DiscordFile;
+}
+export interface DiscordFile {
+    name: string;
+    data: Uint8Array;
+}
+/** Why `cfg` cannot be saved as an enabled config, or null. */
+export declare function discordConfigProblem(cfg: DiscordConfig): string | null;
+/** First four and last two characters, so the user can tell which token is saved. */
+export declare function maskToken(token: string): string;
+/**
+ * A Discord reply as one printable line plus Enter, or null when nothing printable is left. The caller
+ * drops the Enter for a lone digit answering a pending dialog.
+ */
+export declare function sanitiseReply(raw: string, files?: string[]): string | null;
+export declare function threadNameFor(sessionName: string | undefined, sessionId: string): string;
+/** Whether `urgency` earns a ping under `mode`. */
+export declare function shouldPing(mode: DiscordPingMode, urgency: WebhookUrgency, explicitUrgent?: boolean): boolean;
+export declare function shouldSendDiscord(cfg: DiscordConfig, urgency: WebhookUrgency): boolean;
+/** Largest single file taken from Discord, or sent to it. Discord's own free limit is higher. */
+export declare const MAX_FILE_BYTES: number;
+/** Where a session's received files go, relative to its working folder. */
+export declare const RECEIVED_DIR = ".codeman-discord";
+/**
+ * What a session is told about the bridge. Claude gets it as `--append-system-prompt`; no other CLI
+ * is told. No apostrophes: it is rendered into a shell command.
+ */
+export declare const DISCORD_STARTUP_HINT: string;
+/** The hint to launch Claude with, or undefined while the bridge or the setting is off. */
+export declare function getDiscordStartupHint(): string | undefined;
+/**
+ * The last lines of a rendered screen for a post: colour and charset codes removed, blank lines and
+ * pure rule lines (box drawing, dashes) dropped, the last 14 lines, at most 900 characters, cut on a line.
+ * With `composerGlyph` (the CLI's own prompt mark), the composer row and everything under it (the status
+ * and mode hints) is cut first, but only within the last 8 rows and never a dialog's selected option
+ * (`❯ 1. Yes`), so a question's choices stay.
+ */
+export declare function screenTail(screen: string, maxLines?: number, maxChars?: number, composerGlyph?: string): string;
+/**
+ * Discord does not render Markdown tables: a `| a | b |` block shows as raw pipes. Each table outside a
+ * code fence becomes a code block with the columns padded to their widest cell (right-aligned where the
+ * separator row says `---:`), which a monospace font lines up. Bold and code marks inside a cell are
+ * dropped, since a code block would show them literally.
+ */
+export declare function tablesToCodeBlocks(text: string): string;
+/**
+ * Split a long message into posts of at most `max` characters, on blank lines first, then lines, then
+ * (for one huge line) by length. A code fence the cut lands inside is closed and reopened, so each post
+ * renders on its own. At most `maxPosts`; the last carries a note when text is left over.
+ */
+export declare function splitForDiscord(text: string, max?: number, maxPosts?: number): string[];
+/** Final path segment only, `[A-Za-z0-9._-]`, no leading dot, at most 80 characters. */
+export declare function safeAttachmentName(name: string): string;
+/** Discord's own CDN over https: the only place an attachment URL may point. */
+export declare function isDiscordCdnUrl(raw: string): boolean;
+export interface DiscordPost {
+    content: string;
+    allowed_mentions: {
+        parse: string[];
+        users: string[];
+    };
+}
+export declare function buildPost(msg: DiscordMessage, cfg: DiscordConfig, explicitUrgent?: boolean): DiscordPost;
+export declare function discordConfigPath(configDir: string): string;
+export declare function readDiscordConfig(configDir: string): Promise<DiscordConfig>;
+/** 0600 via tmp+rename: `mode` on writeFile only applies to a file being created. */
+export declare function writeDiscordConfig(configDir: string, cfg: DiscordConfig): Promise<void>;
+export declare function readThreadMap(configDir: string): Promise<Record<string, string>>;
+export interface DiscordThreadInfo {
+    id: string;
+    parent_id?: string;
+    owner_id?: string;
+    thread_metadata?: {
+        archived?: boolean;
+    };
+}
+export type DiscordFetch = (target: URL, init: RequestInit) => Promise<Response>;
+export declare class DiscordHttpError extends Error {
+    readonly status: number;
+    /** Discord's own error code (10003 unknown channel, 50001 missing access ...). */
+    readonly code?: number | undefined;
+    constructor(status: number, 
+    /** Discord's own error code (10003 unknown channel, 50001 missing access ...). */
+    code?: number | undefined);
+}
+/** Thin REST client. The token goes only in the Authorization header and never into a message. */
+export declare class DiscordApi {
+    private readonly token;
+    private readonly fetchImpl;
+    private readonly sleep;
+    constructor(token: () => string, fetchImpl: DiscordFetch, sleep?: (ms: number) => Promise<void>);
+    request<T = unknown>(method: string, path: string, body?: unknown, retried?: boolean): Promise<T | null>;
+    createThread(parentId: string, name: string): Promise<{
+        id: string;
+    } | null>;
+    post(channelId: string, p: DiscordPost): Promise<{
+        id: string;
+    } | null>;
+    postWithFile(channelId: string, p: DiscordPost, file: DiscordFile): Promise<{
+        id: string;
+    } | null>;
+    rename(threadId: string, name: string): Promise<unknown>;
+    archive(threadId: string): Promise<unknown>;
+    remove(threadId: string): Promise<unknown>;
+    botUserId(): Promise<{
+        id: string;
+    } | null>;
+    /** Active threads of the guild (all channels: the caller filters by parent). */
+    activeThreads(guildId: string): Promise<{
+        threads: DiscordThreadInfo[];
+    } | null>;
+    /** The most recent archived public threads of a channel (one page). */
+    archivedThreads(parentId: string): Promise<{
+        threads: DiscordThreadInfo[];
+    } | null>;
+    react(channelId: string, messageId: string, emoji: string): Promise<unknown>;
+}
+export interface GatewayMessage {
+    id: string;
+    channel_id: string;
+    guild_id?: string;
+    content: string;
+    author: {
+        id: string;
+        bot?: boolean;
+    };
+    attachments?: Array<{
+        id: string;
+        filename: string;
+        size: number;
+        url: string;
+    }>;
+}
+/** The subset of `ws` the gateway uses, so tests can drive it without a socket. */
+export interface GatewaySocket {
+    send(data: string): void;
+    close(code?: number): void;
+    on(event: 'message', cb: (data: {
+        toString(): string;
+    }) => void): void;
+    on(event: 'close', cb: (code: number) => void): void;
+    on(event: 'error', cb: (err: Error) => void): void;
+}
+export type SocketFactory = (url: string) => GatewaySocket;
+/**
+ * Inbound half: identify, heartbeat, resume and reconnect with backoff. Only MESSAGE_CREATE is
+ * surfaced. A close code that retrying cannot fix (bad token, intent not enabled) stops it and
+ * records `lastError` for the Settings status line.
+ */
+export declare class DiscordGateway {
+    private readonly token;
+    private readonly onMessage;
+    private readonly socketFactory;
+    private readonly backoffMs;
+    state: DiscordGatewayState;
+    lastError: string | null;
+    private sock;
+    private seq;
+    private sessionId;
+    private resumeUrl;
+    private hb;
+    private retry;
+    private acked;
+    private attempts;
+    private stopped;
+    constructor(token: () => string, onMessage: (m: GatewayMessage) => void, socketFactory?: SocketFactory, backoffMs?: (attempt: number) => number);
+    start(): void;
+    stop(): void;
+    private clearTimers;
+    private connect;
+    private scheduleReconnect;
+    private handle;
+}
+/**
+ * Create or re-verify `<workingDir>/.codeman-discord`, or null when it is not safe to write there.
+ * Same safeguards as the prompt uploads folder: the workspace is probed with the bounded probe before
+ * the first disk touch (a dead mount must not hang the event loop), a symlink or a non-directory at
+ * the folder is refused (an agent could plant `.codeman-discord -> ~/.ssh`), and the folder ignores
+ * itself with a `.gitignore` of `*`, written once with O_EXCL so an `git add -A` never commits what was
+ * sent and a file already there stays the user's.
+ */
+export declare function ensureReceivedDir(workingDir: string): Promise<string | null>;
+export interface DiscordBridgeDeps {
+    configDir: string;
+    fetchImpl: DiscordFetch;
+    /**
+     * Types a person's Discord reply into the session (a line ending in Enter, or a lone digit for a
+     * dialog). False when the session is gone.
+     */
+    sendInput: (sessionId: string, text: string) => Promise<boolean>;
+    /** True once the tab's agent has exited: tmux still accepts keys for a dead pane, so a tick would lie. */
+    agentExited?: (sessionId: string) => boolean;
+    /** True while the session shows a permission or question dialog, which acts on a bare keypress. */
+    awaitingChoice?: (sessionId: string) => boolean;
+    /** A session's working folder, where received files are saved. Undefined when it is gone or remote. */
+    sessionDir?: (sessionId: string) => string | undefined;
+    socketFactory?: SocketFactory;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    backoffMs?: (attempt: number) => number;
+}
+export declare class DiscordBridge {
+    private readonly deps;
+    private cfg;
+    private threads;
+    private loaded;
+    private gateway;
+    /** The token the running gateway was started with ('' when none). */
+    private gatewayToken;
+    private lastSent;
+    private lastReply;
+    /** The last name seen per session, so only a real rename touches the thread. */
+    private names;
+    private pending;
+    /** Tabs closed while their thread was still being created: the creation applies `onSessionDelete` to it. */
+    private closedWhilePending;
+    /** The last whole message posted per tab, so the same text is not posted twice (idle, then stop). */
+    private lastFull;
+    /** The parent channel the thread map was built under. */
+    private threadsParent;
+    /** True from boot until the restored tabs exist (see hold). */
+    private held;
+    /** Thread-map writes run one after another: concurrent creations must not interleave on the tmp file. */
+    private persistChain;
+    /** Per-thread chain of inbound messages (see onGatewayMessage). */
+    private inbound;
+    private mapLoad?;
+    private sweepTimer?;
+    /** The first full load (config, thread map, gateway), shared by every caller that arrives before it ends. */
+    private firstLoad?;
+    private last;
+    private readonly api;
+    private readonly now;
+    constructor(deps: DiscordBridgeDeps);
+    get lastResult(): DiscordResult | null;
+    get gatewayState(): DiscordGatewayState;
+    get gatewayError(): string | null;
+    ensureLoaded(): Promise<void>;
+    /** Forget thread entries for tabs that no longer exist (dropped without a delete, for example). Once, at boot. */
+    prune(liveIds: Iterable<string>): Promise<void>;
+    /**
+     * Close threads in the parent channel that this bot made and no tab maps to (`staleThreads`). Runs after
+     * the boot prune, then daily. Never touches a thread someone else made (owner is the bot), a young one
+     * (its map entry may not be written yet), or anything while the map is empty (a lost map would make
+     * every thread look stale). Returns how many it archived or deleted. Never throws.
+     */
+    sweepStaleThreads(): Promise<number>;
+    /** Sweep now, then daily. The timer does not keep the process alive and `stop()` clears it. */
+    startStaleSweep(): void;
+    /** Hold the gateway back (boot): a reply must not arrive before the restored tabs exist. */
+    hold(): void;
+    /** Boot is done: start the gateway if the bridge is on. */
+    release(): Promise<void>;
+    /** (Re)read the config and start or stop the gateway to match. Call at boot and after a save. */
+    reload(): Promise<void>;
+    stop(): void;
+    private fail;
+    private persistThreads;
+    /** The thread for a session, creating it when absent. Concurrent callers share one creation. */
+    private threadFor;
+    /** Post an alert. Session-less messages go to the parent channel. Never throws. */
+    notify(msg: DiscordMessage, opts?: {
+        urgent?: boolean;
+        deliberate?: boolean;
+    }): Promise<DiscordResult | null>;
+    /** A deliberate test send to the parent channel: bypasses `enabled`, scope and dedupe. */
+    sendTest(cfg: DiscordConfig, host?: string): Promise<DiscordResult>;
+    /** Session tab created: make its thread now when `threadCreation` is `onSessionStart`. */
+    sessionCreated(sessionId: string, name: string | undefined): Promise<void>;
+    sessionRenamed(sessionId: string, name: string | undefined): Promise<void>;
+    /**
+     * Drop the per-tab state only, keeping the thread and its map entry. For a session that is discarded
+     * but can come back under the same id (a failed reboot-restore rebuild stays on offer for a retry).
+     * Per-tab state goes whether or not the tab ever had a thread, so these maps cannot grow for the life of the server.
+     */
+    forgetTab(sessionId: string): void;
+    /** Session tab deleted: apply `onSessionDelete` and forget the mapping. */
+    sessionDeleted(sessionId: string): Promise<void>;
+    /** Apply `onSessionDelete` to a thread. */
+    private closeThread;
+    private say;
+    /**
+     * Save a reply's attachments under the session's working folder and return the paths. Only Discord
+     * CDN URLs, at most 5 files of 8 MB each, names reduced to safe characters. Anything skipped is
+     * named in `refused`, so the person is not left guessing why a file did not arrive.
+     */
+    private saveAttachments;
+    /** Inbound reply. One chain per thread, so a reply that waits on a file download cannot be overtaken by a later one. */
+    onGatewayMessage(m: GatewayMessage): Promise<void>;
+    /** Every gate here drops silently: a stranger learns nothing. */
+    private handleMessage;
+}
+//# sourceMappingURL=discord-bridge.d.ts.map

package/dist/discord-bridge.d.ts.map

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