@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.70

package/dist/adapters/commands/manifest.js

@@ -0,0 +1,155 @@
+/**
+ * Platform-agnostic command manifest — the single inventory that platform
+ * adapters derive their native slash-command registration and routing from,
+ * and that `isCommandText` and the handler grammars mirror.
+ *
+ * Adding a command means adding a manifest entry plus a handler in this
+ * directory; adapters pick up registration and routing from the entry instead
+ * of hand-restating the inventory (where a missed spot used to mean a silent
+ * no-response).
+ *
+ * Per CONTEXT.md, slash commands are a minimal chat control surface: detailed
+ * or infrequent settings belong in Admin, and bare commands are limited to
+ * `session`. `stop` is listed for platform registration/UI only — it is a
+ * magic word owned by conversation intake, not a command handler.
+ */
+/** Entry order is the Telegram command-menu order. */
+export const COMMAND_MANIFEST = [
+    {
+        name: "login",
+        description: "Store credentials in your private vault",
+        slackCommand: "/pi-login",
+        slackRoute: { includeText: true, privateCommand: true },
+        discord: true,
+        telegramMenu: {},
+    },
+    {
+        name: "session",
+        description: "Open the current session in the web viewer",
+        bare: true,
+        slackCommand: "/pi-session",
+        slackRoute: { thread: true },
+        discord: true,
+        telegramMenu: {},
+    },
+    {
+        name: "model",
+        description: "Switch this conversation's LLM model",
+        arg: {
+            name: "model",
+            description: "provider/model[:thinking], e.g. anthropic/claude-sonnet-4-6:off",
+            required: false,
+        },
+        slackCommand: "/pi-model",
+        slackRoute: { includeText: true },
+        discord: true,
+        telegramMenu: {},
+    },
+    {
+        name: "sandbox",
+        description: "Show sandbox status or boost limits",
+        arg: {
+            name: "action",
+            // Discord caps option descriptions at 100 characters (registration
+            // fails otherwise); commands.test.ts enforces the budget.
+            // The `door` action still works but is deliberately undocumented: the
+            // workspace posture follows the platform's own channel visibility
+            // automatically, and overriding it is an admin escape hatch, not a
+            // user-facing feature.
+            description: "'boost' temporarily applies the configured boost limits",
+            required: false,
+        },
+        slackCommand: "/pi-sandbox",
+        slackRoute: { includeText: true },
+        discord: true,
+        telegramMenu: { description: "Show or boost sandbox limits" },
+        telegramCommand: true,
+    },
+    {
+        name: "autoreply",
+        aliases: ["auto-reply"],
+        description: "Enable, disable, or Jev-assist replies without mentions",
+        arg: {
+            name: "state",
+            description: "on, off, or jev",
+            required: true,
+        },
+        slackCommand: "/pi-auto-reply",
+        slackRoute: { includeText: true },
+    },
+    {
+        name: "stop",
+        description: "Stop the current conversation",
+        magicWord: true,
+        discord: true,
+        telegramMenu: { description: "Stop ongoing conversation" },
+    },
+    {
+        name: "new",
+        description: "Reset conversation history and start fresh",
+        slackCommand: "/pi-new",
+        slackRoute: {},
+        discord: true,
+        telegramMenu: {},
+        telegramCommand: true,
+    },
+    {
+        name: "admin",
+        description: "Open the admin portal",
+        slackCommand: "/pi-admin",
+        slackRoute: { thread: true },
+        discord: true,
+        telegramMenu: {},
+        telegramCommand: true,
+    },
+];
+export function commandManifestEntry(name) {
+    const entry = COMMAND_MANIFEST.find((candidate) => candidate.name === name);
+    if (!entry)
+        throw new Error(`Unknown command in manifest: ${name}`);
+    return entry;
+}
+/** Slash spellings of a command: `/<name>` and `/pi-<name>` for the name and each alias. */
+export function slashForms(name) {
+    const entry = commandManifestEntry(name);
+    return [entry.name, ...(entry.aliases ?? [])].flatMap((spelling) => [
+        `/${spelling}`,
+        `/pi-${spelling}`,
+    ]);
+}
+/** Every accepted spelling: the bare name (when the command is bare) plus slash forms. */
+export function commandForms(name) {
+    const entry = commandManifestEntry(name);
+    return [...(entry.bare ? [entry.name] : []), ...slashForms(name)];
+}
+/** Telegram `setMyCommands` payload (menu registration; routing is separate). */
+export function telegramCommandMenu() {
+    return COMMAND_MANIFEST.filter((entry) => entry.telegramMenu).map((entry) => ({
+        command: entry.name,
+        description: entry.telegramMenu?.description ?? entry.description,
+    }));
+}
+export function matchCommand(text, aliases, options) {
+    const tokens = text.trim().split(/\s+/).filter(Boolean);
+    const first = tokens[0];
+    if (first === undefined)
+        return null;
+    const token = options?.stripMention ? first.replace(/@\w+$/i, "") : first;
+    const command = token.toLowerCase();
+    return aliases.includes(command) ? { command, args: tokens.slice(1) } : null;
+}
+/**
+ * Chat-command text recognition, derived from the command manifest so the
+ * inventory has a single source of truth. Session resume uses it to keep
+ * command messages out of replayed history.
+ *
+ * The `pi-[\w-]+` alternative is a catch-all for platform-prefixed command
+ * names (including ones a platform registers but this build no longer
+ * handles), independent of the manifest.
+ */
+const COMMAND_NAMES = COMMAND_MANIFEST.flatMap((entry) => [entry.name].concat(entry.aliases ?? []));
+const COMMAND_TEXT_PATTERN = new RegExp(`^\\/(?:pi-[\\w-]+|${COMMAND_NAMES.join("|")})(?:@\\w+)?(?:\\s|$)`, "i");
+export function isCommandText(text) {
+    return COMMAND_TEXT_PATTERN.test(text.trim());
+}
+//# sourceMappingURL=manifest.js.map

package/dist/adapters/commands/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/adapters/commands/manifest.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Platform-agnostic command manifest — the single inventory that platform\n * adapters derive their native slash-command registration and routing from,\n * and that `isCommandText` and the handler grammars mirror.\n *\n * Adding a command means adding a manifest entry plus a handler in this\n * directory; adapters pick up registration and routing from the entry instead\n * of hand-restating the inventory (where a missed spot used to mean a silent\n * no-response).\n *\n * Per CONTEXT.md, slash commands are a minimal chat control surface: detailed\n * or infrequent settings belong in Admin, and bare commands are limited to\n * `session`. `stop` is listed for platform registration/UI only — it is a\n * magic word owned by conversation intake, not a command handler.\n */\n\nimport type { CommandManifestEntry } from \"./types.js\";\n\nexport type { CommandManifestEntry, SlackSlashRoute } from \"./types.js\";\n\n/** Entry order is the Telegram command-menu order. */\nexport const COMMAND_MANIFEST: readonly CommandManifestEntry[] = [\n  {\n    name: \"login\",\n    description: \"Store credentials in your private vault\",\n    slackCommand: \"/pi-login\",\n    slackRoute: { includeText: true, privateCommand: true },\n    discord: true,\n    telegramMenu: {},\n  },\n  {\n    name: \"session\",\n    description: \"Open the current session in the web viewer\",\n    bare: true,\n    slackCommand: \"/pi-session\",\n    slackRoute: { thread: true },\n    discord: true,\n    telegramMenu: {},\n  },\n  {\n    name: \"model\",\n    description: \"Switch this conversation's LLM model\",\n    arg: {\n      name: \"model\",\n      description: \"provider/model[:thinking], e.g. anthropic/claude-sonnet-4-6:off\",\n      required: false,\n    },\n    slackCommand: \"/pi-model\",\n    slackRoute: { includeText: true },\n    discord: true,\n    telegramMenu: {},\n  },\n  {\n    name: \"sandbox\",\n    description: \"Show sandbox status or boost limits\",\n    arg: {\n      name: \"action\",\n      // Discord caps option descriptions at 100 characters (registration\n      // fails otherwise); commands.test.ts enforces the budget.\n      // The `door` action still works but is deliberately undocumented: the\n      // workspace posture follows the platform's own channel visibility\n      // automatically, and overriding it is an admin escape hatch, not a\n      // user-facing feature.\n      description: \"'boost' temporarily applies the configured boost limits\",\n      required: false,\n    },\n    slackCommand: \"/pi-sandbox\",\n    slackRoute: { includeText: true },\n    discord: true,\n    telegramMenu: { description: \"Show or boost sandbox limits\" },\n    telegramCommand: true,\n  },\n  {\n    name: \"autoreply\",\n    aliases: [\"auto-reply\"],\n    description: \"Enable, disable, or Jev-assist replies without mentions\",\n    arg: {\n      name: \"state\",\n      description: \"on, off, or jev\",\n      required: true,\n    },\n    slackCommand: \"/pi-auto-reply\",\n    slackRoute: { includeText: true },\n  },\n  {\n    name: \"stop\",\n    description: \"Stop the current conversation\",\n    magicWord: true,\n    discord: true,\n    telegramMenu: { description: \"Stop ongoing conversation\" },\n  },\n  {\n    name: \"new\",\n    description: \"Reset conversation history and start fresh\",\n    slackCommand: \"/pi-new\",\n    slackRoute: {},\n    discord: true,\n    telegramMenu: {},\n    telegramCommand: true,\n  },\n  {\n    name: \"admin\",\n    description: \"Open the admin portal\",\n    slackCommand: \"/pi-admin\",\n    slackRoute: { thread: true },\n    discord: true,\n    telegramMenu: {},\n    telegramCommand: true,\n  },\n];\n\nexport function commandManifestEntry(name: string): CommandManifestEntry {\n  const entry = COMMAND_MANIFEST.find((candidate) => candidate.name === name);\n  if (!entry) throw new Error(`Unknown command in manifest: ${name}`);\n  return entry;\n}\n\n/** Slash spellings of a command: `/<name>` and `/pi-<name>` for the name and each alias. */\nexport function slashForms(name: string): readonly string[] {\n  const entry = commandManifestEntry(name);\n  return [entry.name, ...(entry.aliases ?? [])].flatMap((spelling) => [\n    `/${spelling}`,\n    `/pi-${spelling}`,\n  ]);\n}\n\n/** Every accepted spelling: the bare name (when the command is bare) plus slash forms. */\nexport function commandForms(name: string): readonly string[] {\n  const entry = commandManifestEntry(name);\n  return [...(entry.bare ? [entry.name] : []), ...slashForms(name)];\n}\n\n/** Telegram `setMyCommands` payload (menu registration; routing is separate). */\nexport function telegramCommandMenu(): { command: string; description: string }[] {\n  return COMMAND_MANIFEST.filter((entry) => entry.telegramMenu).map((entry) => ({\n    command: entry.name,\n    description: entry.telegramMenu?.description ?? entry.description,\n  }));\n}\n\nexport function matchCommand<Command extends string>(\n  text: string,\n  aliases: readonly Command[],\n  options?: { stripMention?: boolean },\n): { command: Command; args: string[] } | null {\n  const tokens = text.trim().split(/\\s+/).filter(Boolean);\n  const first = tokens[0];\n  if (first === undefined) return null;\n\n  const token = options?.stripMention ? first.replace(/@\\w+$/i, \"\") : first;\n  const command = token.toLowerCase() as Command;\n  return aliases.includes(command) ? { command, args: tokens.slice(1) } : null;\n}\n\n/**\n * Chat-command text recognition, derived from the command manifest so the\n * inventory has a single source of truth. Session resume uses it to keep\n * command messages out of replayed history.\n *\n * The `pi-[\\w-]+` alternative is a catch-all for platform-prefixed command\n * names (including ones a platform registers but this build no longer\n * handles), independent of the manifest.\n */\nconst COMMAND_NAMES = COMMAND_MANIFEST.flatMap((entry) => [entry.name].concat(entry.aliases ?? []));\n\nconst COMMAND_TEXT_PATTERN = new RegExp(\n  `^\\\\/(?:pi-[\\\\w-]+|${COMMAND_NAMES.join(\"|\")})(?:@\\\\w+)?(?:\\\\s|$)`,\n  \"i\",\n);\n\nexport function isCommandText(text: string): boolean {\n  return COMMAND_TEXT_PATTERN.test(text.trim());\n}\n"]}

package/dist/adapters/commands/model.d.ts

@@ -0,0 +1,15 @@
+import type { CommandContext, CommandHandler, ModelRegistry, ParsedModelCommand } from "./types.js";
+export type { ParsedModelCommand } from "./types.js";
+export declare function parseModelCommand(text: string): ParsedModelCommand | null;
+export declare class ModelCommandHandler implements CommandHandler {
+    private readonly modelRegistry;
+    constructor(modelRegistry: ModelRegistry);
+    tryHandle(context: CommandContext): Promise<boolean>;
+    /**
+     * Resolve the spec against the registry. A `:suffix` is first tried as part
+     * of the model id, then as a thinking level on the bare id — so a model
+     * whose real name contains a colon still wins over the suffix reading.
+     */
+    private selectModel;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/adapters/commands/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/model.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAapG,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CA+BzE;AAoCD,qBAAa,mBAAoB,YAAW,cAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAA1C,YAA6B,aAAa,EAAE,aAAa,EAAI;IACvD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAsDzD;IAED;;;;OAIG;IACH,OAAO,CAAC,WAAW;CA6BpB"}

package/dist/adapters/commands/model.js

@@ -0,0 +1,153 @@
+import { resolveConversationSettings } from "../../settings/index.js";
+import { applyConversationSettings } from "../../settings/apply.js";
+import { slashForms, matchCommand } from "./manifest.js";
+import { replySummary } from "./utils.js";
+const PI_AI_THINKING_LEVELS = [
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+    "max",
+];
+const THINKING_LEVELS = new Set(["off", ...PI_AI_THINKING_LEVELS]);
+const MODEL_COMMANDS = slashForms("model");
+export function parseModelCommand(text) {
+    const matched = matchCommand(text, MODEL_COMMANDS);
+    if (!matched)
+        return null;
+    if (matched.args.length === 0) {
+        return {};
+    }
+    if (matched.args.length !== 1) {
+        return { error: "invalid_spec" };
+    }
+    const spec = matched.args[0];
+    if (spec === undefined) {
+        return { error: "invalid_spec" };
+    }
+    const slash = spec.indexOf("/");
+    if (slash <= 0 || slash === spec.length - 1) {
+        return { error: "invalid_spec" };
+    }
+    const modelSpec = spec.slice(slash + 1);
+    const parsedModel = parseModelThinkingLevel(modelSpec);
+    if (parsedModel.error) {
+        return { error: parsedModel.error };
+    }
+    return {
+        provider: spec.slice(0, slash),
+        ...parsedModel,
+    };
+}
+function parseModelThinkingLevel(modelSpec) {
+    const colon = modelSpec.lastIndexOf(":");
+    if (colon === 0 || colon === modelSpec.length - 1) {
+        return { error: "invalid_spec" };
+    }
+    if (colon < 0) {
+        return { model: modelSpec };
+    }
+    const suffix = modelSpec.slice(colon + 1);
+    return {
+        model: modelSpec.slice(0, colon),
+        modelCandidate: modelSpec,
+        thinkingLevelCandidate: suffix,
+        ...(THINKING_LEVELS.has(suffix)
+            ? { thinkingLevel: suffix }
+            : {}),
+    };
+}
+function formatModelSpec(provider, model, thinkingLevel) {
+    return `${provider}/${model}${thinkingLevel ? `:${thinkingLevel}` : ""}`;
+}
+const USAGE_EXAMPLE = "Example: `/pi-model anthropic/claude-sonnet-4-6:off`";
+export class ModelCommandHandler {
+    constructor(modelRegistry) {
+        this.modelRegistry = modelRegistry;
+    }
+    async tryHandle(context) {
+        const parsed = parseModelCommand(context.commandText);
+        if (!parsed)
+            return false;
+        if (parsed.error) {
+            await replySummary(context, "Model", [
+                "無效的模型參數，請使用 `provider/model[:thinking]`。",
+                USAGE_EXAMPLE,
+            ]);
+            return true;
+        }
+        const office = context.services.workspace.office(context.address);
+        if (!parsed.provider || !parsed.model) {
+            const current = resolveConversationSettings(office);
+            await replySummary(context, "Model", [
+                `Current: \`${formatModelSpec(current.provider, current.model, current.thinkingLevel)}\``,
+                "",
+                "Usage: `/pi-model provider/model[:thinking]`",
+                USAGE_EXAMPLE,
+            ]);
+            return true;
+        }
+        const selection = this.selectModel(parsed.provider, parsed.model, parsed);
+        if ("lines" in selection) {
+            await replySummary(context, "Model", selection.lines);
+            return true;
+        }
+        if (!context.services.runtime) {
+            await replySummary(context, "Model", [
+                "Model command is not configured correctly on the server. Please try again later.",
+            ]);
+            return true;
+        }
+        const result = applyConversationSettings(context.services.runtime, office, {
+            provider: parsed.provider,
+            model: selection.modelId,
+            ...(selection.thinkingLevel ? { thinkingLevel: selection.thinkingLevel } : {}),
+        });
+        if (!result.ok) {
+            await replySummary(context, "Model", [
+                "目前這個 conversation 有執行中的工作，請等它完成或先 `/stop` 後再切換模型。",
+            ]);
+            return true;
+        }
+        await replySummary(context, "Model", [
+            `Switched: \`${formatModelSpec(parsed.provider, selection.modelId, selection.thinkingLevel)}\``,
+            "下一則訊息會使用新模型。",
+        ]);
+        return true;
+    }
+    /**
+     * Resolve the spec against the registry. A `:suffix` is first tried as part
+     * of the model id, then as a thinking level on the bare id — so a model
+     * whose real name contains a colon still wins over the suffix reading.
+     */
+    selectModel(provider, model, parsed) {
+        const exactModelId = parsed.modelCandidate ?? model;
+        if (this.modelRegistry.find(provider, exactModelId))
+            return { modelId: exactModelId };
+        if (parsed.modelCandidate) {
+            const suffix = parsed.thinkingLevelCandidate;
+            if (suffix && !THINKING_LEVELS.has(suffix)) {
+                return {
+                    lines: [
+                        "未知的 thinking level，請使用 `off`、`minimal`、`low`、`medium`、`high`、`xhigh` 或 `max`。",
+                        USAGE_EXAMPLE,
+                    ],
+                };
+            }
+            if (this.modelRegistry.find(provider, model)) {
+                return {
+                    modelId: model,
+                    ...(parsed.thinkingLevel ? { thinkingLevel: parsed.thinkingLevel } : {}),
+                };
+            }
+        }
+        return {
+            lines: [
+                `找不到模型：\`${formatModelSpec(provider, model, parsed.thinkingLevel)}\``,
+                "請確認 provider/model 名稱，或先在 pi models.json 註冊自訂模型。",
+            ],
+        };
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/adapters/commands/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/adapters/commands/model.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { ThinkingLevel as PiAiThinkingLevel } from \"@earendil-works/pi-ai\";\nimport { resolveConversationSettings } from \"../../settings/index.js\";\nimport { applyConversationSettings } from \"../../settings/apply.js\";\nimport { slashForms, matchCommand } from \"./manifest.js\";\nimport type { CommandContext, CommandHandler, ModelRegistry, ParsedModelCommand } from \"./types.js\";\nimport { replySummary } from \"./utils.js\";\n\nconst PI_AI_THINKING_LEVELS = [\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n  \"max\",\n] satisfies PiAiThinkingLevel[];\nconst THINKING_LEVELS = new Set<ThinkingLevel>([\"off\", ...PI_AI_THINKING_LEVELS]);\n\nexport type { ParsedModelCommand } from \"./types.js\";\n\nconst MODEL_COMMANDS = slashForms(\"model\");\n\nexport function parseModelCommand(text: string): ParsedModelCommand | null {\n  const matched = matchCommand(text, MODEL_COMMANDS);\n  if (!matched) return null;\n\n  if (matched.args.length === 0) {\n    return {};\n  }\n\n  if (matched.args.length !== 1) {\n    return { error: \"invalid_spec\" };\n  }\n\n  const spec = matched.args[0];\n  if (spec === undefined) {\n    return { error: \"invalid_spec\" };\n  }\n  const slash = spec.indexOf(\"/\");\n  if (slash <= 0 || slash === spec.length - 1) {\n    return { error: \"invalid_spec\" };\n  }\n\n  const modelSpec = spec.slice(slash + 1);\n  const parsedModel = parseModelThinkingLevel(modelSpec);\n  if (parsedModel.error) {\n    return { error: parsedModel.error };\n  }\n\n  return {\n    provider: spec.slice(0, slash),\n    ...parsedModel,\n  };\n}\n\nfunction parseModelThinkingLevel(modelSpec: string): {\n  model?: string;\n  modelCandidate?: string;\n  thinkingLevelCandidate?: string;\n  thinkingLevel?: ThinkingLevel;\n  error?: \"invalid_spec\";\n} {\n  const colon = modelSpec.lastIndexOf(\":\");\n  if (colon === 0 || colon === modelSpec.length - 1) {\n    return { error: \"invalid_spec\" };\n  }\n  if (colon < 0) {\n    return { model: modelSpec };\n  }\n\n  const suffix = modelSpec.slice(colon + 1);\n  return {\n    model: modelSpec.slice(0, colon),\n    modelCandidate: modelSpec,\n    thinkingLevelCandidate: suffix,\n    ...(THINKING_LEVELS.has(suffix as ThinkingLevel)\n      ? { thinkingLevel: suffix as ThinkingLevel }\n      : {}),\n  };\n}\n\nfunction formatModelSpec(provider: string, model: string, thinkingLevel?: ThinkingLevel): string {\n  return `${provider}/${model}${thinkingLevel ? `:${thinkingLevel}` : \"\"}`;\n}\n\nconst USAGE_EXAMPLE = \"Example: `/pi-model anthropic/claude-sonnet-4-6:off`\";\n\ntype ModelSelection = { modelId: string; thinkingLevel?: ThinkingLevel } | { lines: string[] };\n\nexport class ModelCommandHandler implements CommandHandler {\n  constructor(private readonly modelRegistry: ModelRegistry) {}\n  async tryHandle(context: CommandContext): Promise<boolean> {\n    const parsed = parseModelCommand(context.commandText);\n    if (!parsed) return false;\n\n    if (parsed.error) {\n      await replySummary(context, \"Model\", [\n        \"無效的模型參數，請使用 `provider/model[:thinking]`。\",\n        USAGE_EXAMPLE,\n      ]);\n      return true;\n    }\n\n    const office = context.services.workspace.office(context.address);\n    if (!parsed.provider || !parsed.model) {\n      const current = resolveConversationSettings(office);\n      await replySummary(context, \"Model\", [\n        `Current: \\`${formatModelSpec(current.provider, current.model, current.thinkingLevel)}\\``,\n        \"\",\n        \"Usage: `/pi-model provider/model[:thinking]`\",\n        USAGE_EXAMPLE,\n      ]);\n      return true;\n    }\n\n    const selection = this.selectModel(parsed.provider, parsed.model, parsed);\n    if (\"lines\" in selection) {\n      await replySummary(context, \"Model\", selection.lines);\n      return true;\n    }\n\n    if (!context.services.runtime) {\n      await replySummary(context, \"Model\", [\n        \"Model command is not configured correctly on the server. Please try again later.\",\n      ]);\n      return true;\n    }\n\n    const result = applyConversationSettings(context.services.runtime, office, {\n      provider: parsed.provider,\n      model: selection.modelId,\n      ...(selection.thinkingLevel ? { thinkingLevel: selection.thinkingLevel } : {}),\n    });\n    if (!result.ok) {\n      await replySummary(context, \"Model\", [\n        \"目前這個 conversation 有執行中的工作，請等它完成或先 `/stop` 後再切換模型。\",\n      ]);\n      return true;\n    }\n\n    await replySummary(context, \"Model\", [\n      `Switched: \\`${formatModelSpec(parsed.provider, selection.modelId, selection.thinkingLevel)}\\``,\n      \"下一則訊息會使用新模型。\",\n    ]);\n    return true;\n  }\n\n  /**\n   * Resolve the spec against the registry. A `:suffix` is first tried as part\n   * of the model id, then as a thinking level on the bare id — so a model\n   * whose real name contains a colon still wins over the suffix reading.\n   */\n  private selectModel(provider: string, model: string, parsed: ParsedModelCommand): ModelSelection {\n    const exactModelId = parsed.modelCandidate ?? model;\n    if (this.modelRegistry.find(provider, exactModelId)) return { modelId: exactModelId };\n\n    if (parsed.modelCandidate) {\n      const suffix = parsed.thinkingLevelCandidate;\n      if (suffix && !THINKING_LEVELS.has(suffix as ThinkingLevel)) {\n        return {\n          lines: [\n            \"未知的 thinking level，請使用 `off`、`minimal`、`low`、`medium`、`high`、`xhigh` 或 `max`。\",\n            USAGE_EXAMPLE,\n          ],\n        };\n      }\n      if (this.modelRegistry.find(provider, model)) {\n        return {\n          modelId: model,\n          ...(parsed.thinkingLevel ? { thinkingLevel: parsed.thinkingLevel } : {}),\n        };\n      }\n    }\n\n    return {\n      lines: [\n        `找不到模型：\\`${formatModelSpec(provider, model, parsed.thinkingLevel)}\\``,\n        \"請確認 provider/model 名稱，或先在 pi models.json 註冊自訂模型。\",\n      ],\n    };\n  }\n}\n"]}

package/dist/adapters/commands/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/new.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjE,qBAAa,iBAAkB,YAAW,cAAc;IAChD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAmCzD;CACF"}

package/dist/adapters/commands/new.js

@@ -0,0 +1,41 @@
+import { createConversationMessage } from "../index.js";
+import { slashForms, matchCommand } from "./manifest.js";
+import { replySummary } from "./utils.js";
+const NEW_COMMANDS = slashForms("new");
+export class NewCommandHandler {
+    async tryHandle(context) {
+        if (!matchCommand(context.commandText, NEW_COMMANDS))
+            return false;
+        if (!context.privateConversation) {
+            await replySummary(context, "New Session", [
+                "為了避免誤清除共享上下文，`/new` 目前只能在與機器人的私訊 / DM 中使用。",
+            ]);
+            return true;
+        }
+        if (!context.services.runtime) {
+            await replySummary(context, "New Session", [
+                "New command is not configured correctly on the server.",
+                "Please try again later.",
+            ]);
+            return true;
+        }
+        await context.services.runtime.handleNewCommand({
+            sessionKey: context.sessionKey,
+            conversationId: context.conversationId,
+            bot: context.bot,
+            message: createConversationMessage({
+                platform: context.address.platform,
+                conversationId: context.address.conversationId,
+                address: context.address,
+                id: `memory:${context.sessionKey}`,
+                sessionKey: context.sessionKey,
+                conversationKind: "direct",
+                userId: context.platformUserId,
+                userName: context.platformUserName,
+                text: context.commandText,
+            }),
+        });
+        return true;
+    }
+}
+//# sourceMappingURL=new.js.map

package/dist/adapters/commands/new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../../src/adapters/commands/new.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAEvC,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,SAAS,CAAC,OAAuB;QACrC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;YAAE,OAAO,KAAK,CAAC;QAEnE,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;YACjC,MAAM,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE;gBACzC,4CAA4C;aAC7C,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE;gBACzC,wDAAwD;gBACxD,yBAAyB;aAC1B,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC;YAC9C,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,yBAAyB,CAAC;gBACjC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ;gBAClC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc;gBAC9C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,EAAE,EAAE,UAAU,OAAO,CAAC,UAAU,EAAE;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,gBAAgB,EAAE,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,cAAc;gBAC9B,QAAQ,EAAE,OAAO,CAAC,gBAAgB;gBAClC,IAAI,EAAE,OAAO,CAAC,WAAW;aAC1B,CAAC;SACH,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["import { createConversationMessage } from \"../index.js\";\nimport { slashForms, matchCommand } from \"./manifest.js\";\nimport type { CommandContext, CommandHandler } from \"./types.js\";\nimport { replySummary } from \"./utils.js\";\n\nconst NEW_COMMANDS = slashForms(\"new\");\n\nexport class NewCommandHandler implements CommandHandler {\n  async tryHandle(context: CommandContext): Promise<boolean> {\n    if (!matchCommand(context.commandText, NEW_COMMANDS)) return false;\n\n    if (!context.privateConversation) {\n      await replySummary(context, \"New Session\", [\n        \"為了避免誤清除共享上下文，`/new` 目前只能在與機器人的私訊 / DM 中使用。\",\n      ]);\n      return true;\n    }\n\n    if (!context.services.runtime) {\n      await replySummary(context, \"New Session\", [\n        \"New command is not configured correctly on the server.\",\n        \"Please try again later.\",\n      ]);\n      return true;\n    }\n\n    await context.services.runtime.handleNewCommand({\n      sessionKey: context.sessionKey,\n      conversationId: context.conversationId,\n      bot: context.bot,\n      message: createConversationMessage({\n        platform: context.address.platform,\n        conversationId: context.address.conversationId,\n        address: context.address,\n        id: `memory:${context.sessionKey}`,\n        sessionKey: context.sessionKey,\n        conversationKind: \"direct\",\n        userId: context.platformUserId,\n        userName: context.platformUserName,\n        text: context.commandText,\n      }),\n    });\n    return true;\n  }\n}\n"]}

package/dist/adapters/commands/registry.d.ts

@@ -0,0 +1,5 @@
+import type { CommandContext, CommandHandler, ModelRegistry } from "./types.js";
+export declare function defaultCommandHandlers(modelRegistry?: ModelRegistry): CommandHandler[];
+/** Run handlers in order, returning true as soon as one accepts the command. */
+export declare function dispatchCommand(handlers: readonly CommandHandler[], context: CommandContext): Promise<boolean>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/adapters/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAmBhF,wBAAgB,sBAAsB,CACpC,aAAa,GAAE,aAAoC,GAClD,cAAc,EAAE,CAUlB;AAED,gFAAgF;AAChF,wBAAsB,eAAe,CACnC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/adapters/commands/registry.js

@@ -0,0 +1,43 @@
+import { MikanModels } from "../../harness/index.js";
+import { AdminCommandHandler } from "./admin.js";
+import { AutoReplyCommandHandler } from "./auto-reply.js";
+import { LoginCommandHandler } from "./login.js";
+import { COMMAND_MANIFEST } from "./manifest.js";
+import { ModelCommandHandler } from "./model.js";
+import { NewCommandHandler } from "./new.js";
+import { SandboxCommandHandler } from "./sandbox.js";
+import { SessionViewCommandHandler } from "./session-view.js";
+/**
+ * Handler factory per manifest command name. The manifest is the inventory
+ * authority; this map only binds each entry to its implementation, and
+ * `defaultCommandHandlers` verifies the binding is complete so a manifest
+ * entry without a handler fails at construction instead of dispatching into
+ * silence. Magic-word entries (routed by conversation intake) are exempt.
+ */
+const HANDLER_FACTORIES = {
+    admin: () => new AdminCommandHandler(),
+    autoreply: () => new AutoReplyCommandHandler(),
+    login: () => new LoginCommandHandler(),
+    session: () => new SessionViewCommandHandler(),
+    model: (modelRegistry) => new ModelCommandHandler(modelRegistry),
+    sandbox: () => new SandboxCommandHandler(),
+    new: () => new NewCommandHandler(),
+};
+export function defaultCommandHandlers(modelRegistry = MikanModels.create()) {
+    return COMMAND_MANIFEST.filter((entry) => !entry.magicWord).map((entry) => {
+        const factory = HANDLER_FACTORIES[entry.name];
+        if (!factory) {
+            throw new Error(`Command manifest entry "${entry.name}" has no handler factory in commands/registry.ts`);
+        }
+        return factory(modelRegistry);
+    });
+}
+/** Run handlers in order, returning true as soon as one accepts the command. */
+export async function dispatchCommand(handlers, context) {
+    for (const handler of handlers) {
+        if (await handler.tryHandle(context))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=registry.js.map

package/dist/adapters/commands/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/adapters/commands/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAG9D;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAqE;IAC1F,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE;IACtC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,EAAE;IAC9C,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE;IACtC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,yBAAyB,EAAE;IAC9C,KAAK,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,aAAa,CAAC;IAChE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE;IAC1C,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;CACnC,CAAC;AAEF,MAAM,UAAU,sBAAsB,CACpC,aAAa,GAAkB,WAAW,CAAC,MAAM,EAAE;IAEnD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,2BAA2B,KAAK,CAAC,IAAI,kDAAkD,CACxF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAmC,EACnC,OAAuB;IAEvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { MikanModels } from \"../../harness/index.js\";\nimport { AdminCommandHandler } from \"./admin.js\";\nimport { AutoReplyCommandHandler } from \"./auto-reply.js\";\nimport { LoginCommandHandler } from \"./login.js\";\nimport { COMMAND_MANIFEST } from \"./manifest.js\";\nimport { ModelCommandHandler } from \"./model.js\";\nimport { NewCommandHandler } from \"./new.js\";\nimport { SandboxCommandHandler } from \"./sandbox.js\";\nimport { SessionViewCommandHandler } from \"./session-view.js\";\nimport type { CommandContext, CommandHandler, ModelRegistry } from \"./types.js\";\n\n/**\n * Handler factory per manifest command name. The manifest is the inventory\n * authority; this map only binds each entry to its implementation, and\n * `defaultCommandHandlers` verifies the binding is complete so a manifest\n * entry without a handler fails at construction instead of dispatching into\n * silence. Magic-word entries (routed by conversation intake) are exempt.\n */\nconst HANDLER_FACTORIES: Record<string, (modelRegistry: ModelRegistry) => CommandHandler> = {\n  admin: () => new AdminCommandHandler(),\n  autoreply: () => new AutoReplyCommandHandler(),\n  login: () => new LoginCommandHandler(),\n  session: () => new SessionViewCommandHandler(),\n  model: (modelRegistry) => new ModelCommandHandler(modelRegistry),\n  sandbox: () => new SandboxCommandHandler(),\n  new: () => new NewCommandHandler(),\n};\n\nexport function defaultCommandHandlers(\n  modelRegistry: ModelRegistry = MikanModels.create(),\n): CommandHandler[] {\n  return COMMAND_MANIFEST.filter((entry) => !entry.magicWord).map((entry) => {\n    const factory = HANDLER_FACTORIES[entry.name];\n    if (!factory) {\n      throw new Error(\n        `Command manifest entry \"${entry.name}\" has no handler factory in commands/registry.ts`,\n      );\n    }\n    return factory(modelRegistry);\n  });\n}\n\n/** Run handlers in order, returning true as soon as one accepts the command. */\nexport async function dispatchCommand(\n  handlers: readonly CommandHandler[],\n  context: CommandContext,\n): Promise<boolean> {\n  for (const handler of handlers) {\n    if (await handler.tryHandle(context)) return true;\n  }\n  return false;\n}\n"]}

package/dist/adapters/commands/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/adapters/commands/sandbox.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvF,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAe7E;AAED,qBAAa,qBAAsB,YAAW,cAAc;IACpD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBzD;CACF"}

package/dist/adapters/commands/sandbox.js

@@ -0,0 +1,125 @@
+import { resolveWorkspaceProjection } from "../../office/projection.js";
+import { runtimeResourceKey } from "../../sandbox/identity.js";
+import { applyOfficeVisibility } from "../../settings/apply.js";
+import { slashForms, matchCommand } from "./manifest.js";
+import { replySummary } from "./utils.js";
+const SANDBOX_COMMANDS = slashForms("sandbox");
+export function parseSandboxCommand(text) {
+    const matched = matchCommand(text, SANDBOX_COMMANDS, { stripMention: true });
+    if (!matched)
+        return null;
+    const action = matched.args[0]?.toLowerCase();
+    if (action === "boost" && matched.args.length === 1) {
+        return { action };
+    }
+    if (action === "visibility" && matched.args.length <= 2) {
+        return {
+            action,
+            ...(matched.args.length === 2 ? { visibility: matched.args[1]?.toLowerCase() } : {}),
+        };
+    }
+    return {};
+}
+export class SandboxCommandHandler {
+    async tryHandle(context) {
+        const parsed = parseSandboxCommand(context.commandText);
+        if (!parsed)
+            return false;
+        if (context.services.sandbox.type !== "image" || !context.services.resourceController) {
+            await replySummary(context, "Sandbox", [
+                "`/pi-sandbox` 目前只支援 `image:*` managed sandbox。",
+            ]);
+            return true;
+        }
+        const controller = context.services.resourceController;
+        const containerKey = runtimeResourceKey(context.services.sandbox, {
+            userId: context.platformUserId,
+            address: context.address,
+        });
+        if (parsed.action === "boost") {
+            await handleBoost(context, controller, containerKey);
+        }
+        else if (parsed.action === "visibility") {
+            await handleVisibility(context, parsed);
+        }
+        else {
+            await showSandboxStatus(context, controller, containerKey);
+        }
+        return true;
+    }
+}
+async function handleBoost(context, controller, containerKey) {
+    const boostLimits = controller.getBoostLimits();
+    if (!boostLimits?.cpus && !boostLimits?.memory) {
+        await replySummary(context, "Sandbox Boost", [
+            "此 mikan instance 尚未設定 sandbox boost 規格。",
+            "請先在全域 settings.json 設定 `sandbox.boost`。",
+        ]);
+        return;
+    }
+    const status = await controller.boost(containerKey);
+    await replySummary(context, "Sandbox Boost", [
+        "已暫時提升此 conversation 的 sandbox 規格。",
+        `Current: ${formatLimits(status.limits)}`,
+        "boost 會在此 sandbox runtime 關閉後結束。",
+    ]);
+}
+function describeVisibility(projection) {
+    const source = projection.source === "override"
+        ? "admin 覆寫"
+        : projection.source === "platform"
+            ? "依平台頻道類型"
+            : "Slack 尚未回報頻道類型，預設 private";
+    return `${projection.visibility}（${source}）`;
+}
+async function handleVisibility(context, parsed) {
+    const office = context.services.workspace.office(context.address);
+    const projection = resolveWorkspaceProjection(office);
+    if (parsed.visibility === undefined) {
+        await replySummary(context, "Office Visibility", [
+            `Current: ${describeVisibility(projection)}`,
+            "",
+            "public：其他 office 可唯讀這個 office，且可寫入共用 MEMORY.md / skills。",
+            "private：只有自己看得到，共用 MEMORY.md / skills 唯讀。",
+            "預設跟隨 Slack 頻道類型；private 頻道與 DM 一律 private。",
+            "admin 覆寫：`/pi-sandbox visibility <private|default>`（只能把 public 頻道改為 private）",
+        ]);
+        return;
+    }
+    if (parsed.visibility !== "private" && parsed.visibility !== "default") {
+        await replySummary(context, "Office Visibility", [
+            `未知的值：\`${parsed.visibility}\`。可用值：\`private\`、\`default\``,
+        ]);
+        return;
+    }
+    const result = applyOfficeVisibility(context.services.runtime, office, parsed.visibility === "private" ? "private" : null);
+    if (!result.ok) {
+        await replySummary(context, "Office Visibility", [
+            "目前有工作正在執行，無法切換 visibility。等執行結束後再試一次。",
+        ]);
+        return;
+    }
+    const updated = resolveWorkspaceProjection(office);
+    await replySummary(context, "Office Visibility", [
+        `Visibility 已更新。Current: ${describeVisibility(updated)}`,
+        "下一則訊息時會以新的掛載重建 sandbox 容器；容器內容會保留。",
+    ]);
+}
+async function showSandboxStatus(context, controller, containerKey) {
+    const status = controller.getLimitStatus(containerKey);
+    const defaultLimits = controller.getDefaultLimits();
+    const boostLimits = controller.getBoostLimits();
+    const projection = resolveWorkspaceProjection(context.services.workspace.office(context.address));
+    await replySummary(context, "Sandbox", [
+        `Current: ${formatLimits(status.limits)}`,
+        `Status: ${status.boosted ? "boosted" : "default"}`,
+        `Office visibility: ${describeVisibility(projection)}`,
+        "",
+        `Default: ${formatLimits(defaultLimits)}`,
+        boostLimits ? `Boost: ${formatLimits({ ...defaultLimits, ...boostLimits })}` : undefined,
+    ].filter((line) => line !== undefined));
+}
+function formatLimits(limits) {
+    return `CPU ${limits?.cpus ?? "unlimited"} / Memory ${limits?.memory ?? "unlimited"}`;
+}
+//# sourceMappingURL=sandbox.js.map