@geminixiang/mikan 1.0.0-beta.9 → 1.0.0-beta.91

package/dist/env-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-manifest.d.ts","sourceRoot":"","sources":["../src/env-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/D;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,QAAQ,EA8L3C,CAAC;AAEF,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,SAAmB,GAAG,OAAO,CAI/E;AAOD,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAI1C;AAED,wBAAgB,SAAS,CAAC,GAAG,GAAE,SAAmB,GAAG,MAAM,CAuB1D;AAED,wBAAgB,qBAAqB,CACnC,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAmB,GACnD,MAAM,CAER;AAED,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAIvD"}

package/dist/env-manifest.js

@@ -0,0 +1,255 @@
+export function readEnv(name) {
+    const raw = process.env[name]?.trim();
+    if (raw)
+        return raw;
+    const prefixed = process.env[`MIKAN_${name}`]?.trim();
+    return prefixed || undefined;
+}
+export function readStandardEnv(name) {
+    return process.env[name]?.trim() || undefined;
+}
+export function setEnvAliases(name, value) {
+    process.env[name] = value;
+    process.env[`MIKAN_${name}`] = value;
+}
+export const ENV_MANIFEST = [
+    {
+        key: "slack",
+        title: "Slack",
+        kind: "platform",
+        vars: [
+            {
+                name: "SLACK_APP_TOKEN",
+                required: true,
+                secret: true,
+                doc: "Socket-mode app token (xapp-…)",
+            },
+            { name: "SLACK_BOT_TOKEN", required: true, secret: true, doc: "Bot token (xoxb-…)" },
+        ],
+    },
+    {
+        key: "telegram",
+        title: "Telegram",
+        kind: "platform",
+        vars: [{ name: "TELEGRAM_BOT_TOKEN", required: true, secret: true, doc: "BotFather token" }],
+    },
+    {
+        key: "discord",
+        title: "Discord",
+        kind: "platform",
+        vars: [{ name: "DISCORD_BOT_TOKEN", required: true, secret: true, doc: "Bot token" }],
+    },
+    {
+        key: "github",
+        title: "GitHub",
+        kind: "platform",
+        doc: "Issue/PR conversations as a bound GitHub account, driven by webhooks (needs LINK_PORT)",
+        vars: [
+            {
+                name: "GITHUB_AGENT_TOKEN",
+                required: true,
+                secret: true,
+                doc: "Fine-grained PAT of the agent account; mikan acts on GitHub only as it",
+            },
+            {
+                name: "GITHUB_WEBHOOK_SECRET",
+                required: true,
+                secret: true,
+                doc: "Secret of the webhook that delivers to <LINK_URL>/github/webhook",
+            },
+            {
+                name: "GITHUB_REPOS",
+                required: true,
+                doc: "Comma-separated owner/repo or owner/* the agent answers in",
+            },
+            { name: "GITHUB_PUBLIC_REPOS", doc: "Answer in public repositories too (default false)" },
+            { name: "GITHUB_USERS", doc: "Comma-separated logins allowed to trigger (default: anyone)" },
+            {
+                name: "GITHUB_MIN_PERMISSION",
+                doc: "Repository permission a trigger needs: write, maintain, or admin (default write)",
+            },
+            {
+                name: "GITHUB_TRIGGERS",
+                doc: "Comma-separated mention, assign, review, followup (default all)",
+            },
+            {
+                name: "GITHUB_CAPABILITIES",
+                doc: "Comma-separated triage, push beyond commenting (default none)",
+            },
+        ],
+    },
+    {
+        key: "llm",
+        title: "LLM providers",
+        kind: "feature",
+        vars: [
+            { name: "ANTHROPIC_API_KEY", secret: true, doc: "Anthropic API key" },
+            { name: "OPENAI_API_KEY", secret: true, doc: "OpenAI API key" },
+            {
+                name: "OPENROUTER_API_KEY",
+                secret: true,
+                doc: "OpenRouter API key (chat models routed through OpenRouter, and harness/jev.ts's Jev client via @geminixiang/jev)",
+            },
+        ],
+    },
+    {
+        key: "link",
+        title: "Link/OAuth server",
+        kind: "feature",
+        doc: "Credential onboarding links, session view, and the Admin portal",
+        vars: [
+            { name: "LINK_URL", doc: "Externally visible base URL, e.g. https://mikan.example.com" },
+            { name: "LINK_PORT", doc: "Listen port (default 8181 when LINK_URL is set)" },
+            {
+                name: "LINK_HOST",
+                doc: "Listen address (default 127.0.0.1, for a reverse proxy on the same host)",
+            },
+            { name: "GITHUB_OAUTH_CLIENT_ID", doc: "GitHub OAuth app for /login linking" },
+            { name: "GITHUB_OAUTH_CLIENT_SECRET", secret: true, doc: "GitHub OAuth app secret" },
+            { name: "GOOGLE_WORKSPACE_CLI_CLIENT_ID", doc: "Google Workspace OAuth client for /login" },
+            {
+                name: "GOOGLE_WORKSPACE_CLI_CLIENT_SECRET",
+                secret: true,
+                doc: "Google Workspace OAuth secret",
+            },
+            { name: "GOOGLE_CLOUD_SDK_CLIENT_ID", doc: "Google Cloud SDK OAuth client for /login" },
+            {
+                name: "GOOGLE_CLOUD_SDK_CLIENT_SECRET",
+                secret: true,
+                doc: "Google Cloud SDK OAuth secret",
+            },
+        ],
+    },
+    {
+        key: "openconnector",
+        title: "OpenConnector",
+        kind: "feature",
+        doc: "Default open-connector MCP server and the admin token that mints per-conversation runtime tokens",
+        vars: [
+            {
+                name: "OPENCONNECTOR_ENDPOINT",
+                doc: "Default MCP endpoint used when a conversation does not declare open-connector",
+            },
+            {
+                name: "OPENCONNECTOR_ADMIN_TOKEN",
+                secret: true,
+                doc: "Host-only admin token used to mint one runtime token per conversation for the default server",
+            },
+        ],
+    },
+    {
+        key: "cloudflare",
+        title: "Cloudflare sandbox",
+        kind: "feature",
+        doc: "For --sandbox=cloudflare:<id> via the bridge worker",
+        vars: [
+            { name: "CLOUDFLARE_SANDBOX_URL", doc: "Bridge worker URL" },
+            { name: "CLOUDFLARE_SANDBOX_TOKEN", secret: true, doc: "Bridge worker auth token" },
+        ],
+    },
+    {
+        key: "observability",
+        title: "Observability",
+        kind: "feature",
+        vars: [
+            { name: "SENTRY_DSN", secret: true, doc: "Sentry DSN (settings.json sentry.dsn wins)" },
+            {
+                name: "SENTRY_ENVIRONMENT",
+                deploy: false,
+                doc: "Sentry environment tag (default production)",
+            },
+            { name: "SENTRY_ENABLED", deploy: false, doc: "Set to false to disable Sentry errors" },
+            {
+                name: "SENTRY_TRACES_SAMPLE_RATE",
+                deploy: false,
+                doc: "Sentry trace sample rate, 0 to 1 (default 1; ignored with OTLP traces)",
+            },
+            { name: "OTEL_SDK_DISABLED", doc: "Set to true to disable OpenTelemetry" },
+            { name: "OTEL_SERVICE_NAME", doc: "OTLP service name (default mikan)" },
+            {
+                name: "OTEL_RESOURCE_ATTRIBUTES",
+                secret: true,
+                doc: "Comma-separated safe resource attrs",
+            },
+            { name: "OTEL_TRACES_EXPORTER", doc: "Trace exporter: otlp or none" },
+            { name: "OTEL_METRICS_EXPORTER", doc: "Metrics exporter: otlp or none" },
+            { name: "OTEL_EXPORTER_OTLP_ENDPOINT", secret: true, doc: "Base OTLP HTTP endpoint" },
+            { name: "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT", secret: true, doc: "OTLP traces endpoint" },
+            { name: "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT", secret: true, doc: "OTLP metrics endpoint" },
+            { name: "OTEL_EXPORTER_OTLP_HEADERS", secret: true, doc: "Shared OTLP auth headers" },
+            { name: "OTEL_EXPORTER_OTLP_TRACES_HEADERS", secret: true, doc: "OTLP trace headers" },
+            { name: "OTEL_EXPORTER_OTLP_METRICS_HEADERS", secret: true, doc: "OTLP metric headers" },
+            { name: "OTEL_EXPORTER_OTLP_PROTOCOL", doc: "OTLP protocol; http/protobuf supported" },
+            { name: "OTEL_EXPORTER_OTLP_TRACES_PROTOCOL", doc: "Trace protocol override" },
+            { name: "OTEL_EXPORTER_OTLP_METRICS_PROTOCOL", doc: "Metric protocol override" },
+            { name: "OTEL_EXPORTER_OTLP_TIMEOUT", doc: "Shared OTLP timeout in milliseconds" },
+            { name: "OTEL_EXPORTER_OTLP_TRACES_TIMEOUT", doc: "Trace timeout in milliseconds" },
+            { name: "OTEL_EXPORTER_OTLP_METRICS_TIMEOUT", doc: "Metric timeout in milliseconds" },
+            { name: "OTEL_METRIC_EXPORT_INTERVAL", doc: "Metric export interval in milliseconds" },
+            { name: "OTEL_METRIC_EXPORT_TIMEOUT", doc: "Metric export timeout in milliseconds" },
+        ],
+    },
+    {
+        key: "runtime",
+        title: "Runtime",
+        kind: "feature",
+        vars: [
+            { name: "STATE_DIR", deploy: false, doc: "State dir override (same as --state-dir)" },
+            {
+                name: "HTTP_IDLE_TIMEOUT",
+                deploy: false,
+                doc: "Idle timeout in ms for outbound HTTP streams",
+            },
+        ],
+    },
+];
+export function platformIsActive(key, env = readEnv) {
+    const group = ENV_MANIFEST.find((candidate) => candidate.key === key);
+    if (!group)
+        throw new Error(`Unknown env-manifest group: ${key}`);
+    return group.vars.filter((spec) => spec.required).every((spec) => env(spec.name));
+}
+function platformRecipe(group) {
+    const required = group.vars.filter((spec) => spec.required).map((spec) => spec.name);
+    return `${group.title}: ${required.join(" + ")}`;
+}
+export function noPlatformsMessage() {
+    const recipes = ENV_MANIFEST.filter((group) => group.kind === "platform")
+        .map((group) => `  ${platformRecipe(group)}`)
+        .join("\n");
+    return `No platform tokens found. Set one of:\n${recipes}`;
+}
+export function envSummaryLines() {
+    return ENV_MANIFEST.filter((group) => group.kind === "platform").map((group) => `  ${platformRecipe(group)}`);
+}
+export function envReport(env = readEnv) {
+    const lines = [];
+    for (const group of ENV_MANIFEST) {
+        const active = group.kind === "platform"
+            ? platformIsActive(group.key, env)
+                ? " — active"
+                : " — inactive"
+            : "";
+        lines.push(`${group.title}${active}${group.doc ? ` · ${group.doc}` : ""}`);
+        for (const spec of group.vars) {
+            const status = env(spec.name) ? "set" : "unset";
+            const marks = [spec.required ? "required" : "", spec.secret ? "secret" : ""]
+                .filter(Boolean)
+                .join(", ");
+            lines.push(`  ${spec.name.padEnd(36)} ${status.padEnd(6)}${marks ? ` [${marks}]` : ""}  ${spec.doc}`);
+        }
+        lines.push("");
+    }
+    lines.push("Each var also accepts a MIKAN_-prefixed alias (e.g. MIKAN_LINK_URL).");
+    return lines.join("\n");
+}
+export function resolveLinkListenHost(read = readEnv) {
+    return read("LINK_HOST") ?? "127.0.0.1";
+}
+export function resolveLinkBaseUrl() {
+    const raw = readEnv("LINK_URL");
+    if (!raw)
+        return undefined;
+    return raw.replace(/\/+$/, "");
+}
+//# sourceMappingURL=env-manifest.js.map

package/dist/env-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-manifest.js","sourceRoot":"","sources":["../src/env-manifest.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EnvGroup } from \"./types.js\";\n\nexport function readEnv(name: string): string | undefined {\n  const raw = process.env[name]?.trim();\n  if (raw) return raw;\n\n  const prefixed = process.env[`MIKAN_${name}`]?.trim();\n  return prefixed || undefined;\n}\n\nexport function readStandardEnv(name: string): string | undefined {\n  return process.env[name]?.trim() || undefined;\n}\n\nexport function setEnvAliases(name: string, value: string): void {\n  process.env[name] = value;\n  process.env[`MIKAN_${name}`] = value;\n}\n\nexport const ENV_MANIFEST: readonly EnvGroup[] = [\n  {\n    key: \"slack\",\n    title: \"Slack\",\n    kind: \"platform\",\n    vars: [\n      {\n        name: \"SLACK_APP_TOKEN\",\n        required: true,\n        secret: true,\n        doc: \"Socket-mode app token (xapp-…)\",\n      },\n      { name: \"SLACK_BOT_TOKEN\", required: true, secret: true, doc: \"Bot token (xoxb-…)\" },\n    ],\n  },\n  {\n    key: \"telegram\",\n    title: \"Telegram\",\n    kind: \"platform\",\n    vars: [{ name: \"TELEGRAM_BOT_TOKEN\", required: true, secret: true, doc: \"BotFather token\" }],\n  },\n  {\n    key: \"discord\",\n    title: \"Discord\",\n    kind: \"platform\",\n    vars: [{ name: \"DISCORD_BOT_TOKEN\", required: true, secret: true, doc: \"Bot token\" }],\n  },\n  {\n    key: \"github\",\n    title: \"GitHub\",\n    kind: \"platform\",\n    doc: \"Issue/PR conversations as a bound GitHub account, driven by webhooks (needs LINK_PORT)\",\n    vars: [\n      {\n        name: \"GITHUB_AGENT_TOKEN\",\n        required: true,\n        secret: true,\n        doc: \"Fine-grained PAT of the agent account; mikan acts on GitHub only as it\",\n      },\n      {\n        name: \"GITHUB_WEBHOOK_SECRET\",\n        required: true,\n        secret: true,\n        doc: \"Secret of the webhook that delivers to <LINK_URL>/github/webhook\",\n      },\n      {\n        name: \"GITHUB_REPOS\",\n        required: true,\n        doc: \"Comma-separated owner/repo or owner/* the agent answers in\",\n      },\n      { name: \"GITHUB_PUBLIC_REPOS\", doc: \"Answer in public repositories too (default false)\" },\n      { name: \"GITHUB_USERS\", doc: \"Comma-separated logins allowed to trigger (default: anyone)\" },\n      {\n        name: \"GITHUB_MIN_PERMISSION\",\n        doc: \"Repository permission a trigger needs: write, maintain, or admin (default write)\",\n      },\n      {\n        name: \"GITHUB_TRIGGERS\",\n        doc: \"Comma-separated mention, assign, review, followup (default all)\",\n      },\n      {\n        name: \"GITHUB_CAPABILITIES\",\n        doc: \"Comma-separated triage, push beyond commenting (default none)\",\n      },\n    ],\n  },\n  {\n    key: \"llm\",\n    title: \"LLM providers\",\n    kind: \"feature\",\n    vars: [\n      { name: \"ANTHROPIC_API_KEY\", secret: true, doc: \"Anthropic API key\" },\n      { name: \"OPENAI_API_KEY\", secret: true, doc: \"OpenAI API key\" },\n      {\n        name: \"OPENROUTER_API_KEY\",\n        secret: true,\n        doc: \"OpenRouter API key (chat models routed through OpenRouter, and harness/jev.ts's Jev client via @geminixiang/jev)\",\n      },\n    ],\n  },\n  {\n    key: \"link\",\n    title: \"Link/OAuth server\",\n    kind: \"feature\",\n    doc: \"Credential onboarding links, session view, and the Admin portal\",\n    vars: [\n      { name: \"LINK_URL\", doc: \"Externally visible base URL, e.g. https://mikan.example.com\" },\n      { name: \"LINK_PORT\", doc: \"Listen port (default 8181 when LINK_URL is set)\" },\n      {\n        name: \"LINK_HOST\",\n        doc: \"Listen address (default 127.0.0.1, for a reverse proxy on the same host)\",\n      },\n      { name: \"GITHUB_OAUTH_CLIENT_ID\", doc: \"GitHub OAuth app for /login linking\" },\n      { name: \"GITHUB_OAUTH_CLIENT_SECRET\", secret: true, doc: \"GitHub OAuth app secret\" },\n      { name: \"GOOGLE_WORKSPACE_CLI_CLIENT_ID\", doc: \"Google Workspace OAuth client for /login\" },\n      {\n        name: \"GOOGLE_WORKSPACE_CLI_CLIENT_SECRET\",\n        secret: true,\n        doc: \"Google Workspace OAuth secret\",\n      },\n      { name: \"GOOGLE_CLOUD_SDK_CLIENT_ID\", doc: \"Google Cloud SDK OAuth client for /login\" },\n      {\n        name: \"GOOGLE_CLOUD_SDK_CLIENT_SECRET\",\n        secret: true,\n        doc: \"Google Cloud SDK OAuth secret\",\n      },\n    ],\n  },\n  {\n    key: \"openconnector\",\n    title: \"OpenConnector\",\n    kind: \"feature\",\n    doc: \"Default open-connector MCP server and the admin token that mints per-conversation runtime tokens\",\n    vars: [\n      {\n        name: \"OPENCONNECTOR_ENDPOINT\",\n        doc: \"Default MCP endpoint used when a conversation does not declare open-connector\",\n      },\n      {\n        name: \"OPENCONNECTOR_ADMIN_TOKEN\",\n        secret: true,\n        doc: \"Host-only admin token used to mint one runtime token per conversation for the default server\",\n      },\n    ],\n  },\n  {\n    key: \"cloudflare\",\n    title: \"Cloudflare sandbox\",\n    kind: \"feature\",\n    doc: \"For --sandbox=cloudflare:<id> via the bridge worker\",\n    vars: [\n      { name: \"CLOUDFLARE_SANDBOX_URL\", doc: \"Bridge worker URL\" },\n      { name: \"CLOUDFLARE_SANDBOX_TOKEN\", secret: true, doc: \"Bridge worker auth token\" },\n    ],\n  },\n  {\n    key: \"observability\",\n    title: \"Observability\",\n    kind: \"feature\",\n    vars: [\n      { name: \"SENTRY_DSN\", secret: true, doc: \"Sentry DSN (settings.json sentry.dsn wins)\" },\n      {\n        name: \"SENTRY_ENVIRONMENT\",\n        deploy: false,\n        doc: \"Sentry environment tag (default production)\",\n      },\n      { name: \"SENTRY_ENABLED\", deploy: false, doc: \"Set to false to disable Sentry errors\" },\n      {\n        name: \"SENTRY_TRACES_SAMPLE_RATE\",\n        deploy: false,\n        doc: \"Sentry trace sample rate, 0 to 1 (default 1; ignored with OTLP traces)\",\n      },\n      { name: \"OTEL_SDK_DISABLED\", doc: \"Set to true to disable OpenTelemetry\" },\n      { name: \"OTEL_SERVICE_NAME\", doc: \"OTLP service name (default mikan)\" },\n      {\n        name: \"OTEL_RESOURCE_ATTRIBUTES\",\n        secret: true,\n        doc: \"Comma-separated safe resource attrs\",\n      },\n      { name: \"OTEL_TRACES_EXPORTER\", doc: \"Trace exporter: otlp or none\" },\n      { name: \"OTEL_METRICS_EXPORTER\", doc: \"Metrics exporter: otlp or none\" },\n      { name: \"OTEL_EXPORTER_OTLP_ENDPOINT\", secret: true, doc: \"Base OTLP HTTP endpoint\" },\n      { name: \"OTEL_EXPORTER_OTLP_TRACES_ENDPOINT\", secret: true, doc: \"OTLP traces endpoint\" },\n      { name: \"OTEL_EXPORTER_OTLP_METRICS_ENDPOINT\", secret: true, doc: \"OTLP metrics endpoint\" },\n      { name: \"OTEL_EXPORTER_OTLP_HEADERS\", secret: true, doc: \"Shared OTLP auth headers\" },\n      { name: \"OTEL_EXPORTER_OTLP_TRACES_HEADERS\", secret: true, doc: \"OTLP trace headers\" },\n      { name: \"OTEL_EXPORTER_OTLP_METRICS_HEADERS\", secret: true, doc: \"OTLP metric headers\" },\n      { name: \"OTEL_EXPORTER_OTLP_PROTOCOL\", doc: \"OTLP protocol; http/protobuf supported\" },\n      { name: \"OTEL_EXPORTER_OTLP_TRACES_PROTOCOL\", doc: \"Trace protocol override\" },\n      { name: \"OTEL_EXPORTER_OTLP_METRICS_PROTOCOL\", doc: \"Metric protocol override\" },\n      { name: \"OTEL_EXPORTER_OTLP_TIMEOUT\", doc: \"Shared OTLP timeout in milliseconds\" },\n      { name: \"OTEL_EXPORTER_OTLP_TRACES_TIMEOUT\", doc: \"Trace timeout in milliseconds\" },\n      { name: \"OTEL_EXPORTER_OTLP_METRICS_TIMEOUT\", doc: \"Metric timeout in milliseconds\" },\n      { name: \"OTEL_METRIC_EXPORT_INTERVAL\", doc: \"Metric export interval in milliseconds\" },\n      { name: \"OTEL_METRIC_EXPORT_TIMEOUT\", doc: \"Metric export timeout in milliseconds\" },\n    ],\n  },\n  {\n    key: \"runtime\",\n    title: \"Runtime\",\n    kind: \"feature\",\n    vars: [\n      { name: \"STATE_DIR\", deploy: false, doc: \"State dir override (same as --state-dir)\" },\n      {\n        name: \"HTTP_IDLE_TIMEOUT\",\n        deploy: false,\n        doc: \"Idle timeout in ms for outbound HTTP streams\",\n      },\n    ],\n  },\n];\n\ntype EnvLookup = (name: string) => string | undefined;\n\nexport function platformIsActive(key: string, env: EnvLookup = readEnv): boolean {\n  const group = ENV_MANIFEST.find((candidate) => candidate.key === key);\n  if (!group) throw new Error(`Unknown env-manifest group: ${key}`);\n  return group.vars.filter((spec) => spec.required).every((spec) => env(spec.name));\n}\n\nfunction platformRecipe(group: EnvGroup): string {\n  const required = group.vars.filter((spec) => spec.required).map((spec) => spec.name);\n  return `${group.title}: ${required.join(\" + \")}`;\n}\n\nexport function noPlatformsMessage(): string {\n  const recipes = ENV_MANIFEST.filter((group) => group.kind === \"platform\")\n    .map((group) => `  ${platformRecipe(group)}`)\n    .join(\"\\n\");\n  return `No platform tokens found. Set one of:\\n${recipes}`;\n}\n\nexport function envSummaryLines(): string[] {\n  return ENV_MANIFEST.filter((group) => group.kind === \"platform\").map(\n    (group) => `  ${platformRecipe(group)}`,\n  );\n}\n\nexport function envReport(env: EnvLookup = readEnv): string {\n  const lines: string[] = [];\n  for (const group of ENV_MANIFEST) {\n    const active =\n      group.kind === \"platform\"\n        ? platformIsActive(group.key, env)\n          ? \" — active\"\n          : \" — inactive\"\n        : \"\";\n    lines.push(`${group.title}${active}${group.doc ? ` · ${group.doc}` : \"\"}`);\n    for (const spec of group.vars) {\n      const status = env(spec.name) ? \"set\" : \"unset\";\n      const marks = [spec.required ? \"required\" : \"\", spec.secret ? \"secret\" : \"\"]\n        .filter(Boolean)\n        .join(\", \");\n      lines.push(\n        `  ${spec.name.padEnd(36)} ${status.padEnd(6)}${marks ? ` [${marks}]` : \"\"}  ${spec.doc}`,\n      );\n    }\n    lines.push(\"\");\n  }\n  lines.push(\"Each var also accepts a MIKAN_-prefixed alias (e.g. MIKAN_LINK_URL).\");\n  return lines.join(\"\\n\");\n}\n\nexport function resolveLinkListenHost(\n  read: (name: string) => string | undefined = readEnv,\n): string {\n  return read(\"LINK_HOST\") ?? \"127.0.0.1\";\n}\n\nexport function resolveLinkBaseUrl(): string | undefined {\n  const raw = readEnv(\"LINK_URL\");\n  if (!raw) return undefined;\n  return raw.replace(/\\/+$/, \"\");\n}\n"]}

package/dist/events/index.d.ts

@@ -0,0 +1,105 @@
+import type { OfficeAddress } from "../types.js";
+export type EventPayload = EventFilePayload;
+export interface EventRecord {
+    filename: string;
+    payload: EventFilePayload;
+    size: number;
+    mtimeMs: number;
+}
+export interface EventStore {
+    readonly address: OfficeAddress;
+    create(filename: string, payload: EventFilePayload): Promise<{
+        path: string;
+        size: number;
+    }>;
+    list(): Promise<Array<Omit<EventRecord, "payload"> & {
+        payload: EventFilePayload | null;
+    }>>;
+    read(filename: string): Promise<EventRecord>;
+    update(filename: string, payload: EventFilePayload): Promise<{
+        path: string;
+        size: number;
+    }>;
+    delete(filename: string): Promise<void>;
+}
+export interface EventScheduleSink {
+    scheduleRecord(address: OfficeAddress, record: EventRecord): void;
+    cancelRecord(address: OfficeAddress, filename: string): void;
+}
+export type EventConversationKind = "direct" | "shared";
+export type EventType = "immediate" | "one-shot" | "periodic";
+interface EventPayloadBase {
+    platform?: string;
+    conversationId: string;
+    conversationKind?: EventConversationKind;
+    userId?: string;
+    text: string;
+}
+export interface ImmediateEventPayload extends EventPayloadBase {
+    type: "immediate";
+}
+export interface OneShotEventPayload extends EventPayloadBase {
+    type: "one-shot";
+    at: string;
+}
+export interface PeriodicEventPayload extends EventPayloadBase {
+    type: "periodic";
+    schedule: string;
+    timezone: string;
+}
+export type EventFilePayload = ImmediateEventPayload | OneShotEventPayload | PeriodicEventPayload;
+export interface EventPayloadInput {
+    type: EventType;
+    platform?: string;
+    conversationId: string;
+    conversationKind?: EventConversationKind;
+    userId?: string;
+    text: string;
+    at?: string;
+    schedule?: string;
+    timezone?: string;
+}
+interface ResolvedEventFields {
+    platform: string;
+    conversationKind: EventConversationKind;
+}
+export type MikanEvent = (ImmediateEventPayload & ResolvedEventFields) | (OneShotEventPayload & ResolvedEventFields) | (PeriodicEventPayload & ResolvedEventFields);
+export interface PeriodicEventInfo {
+    platform: string;
+    conversationId: string;
+    text: string;
+    schedule: string;
+    nextRun: string | null;
+}
+import { Type } from "typebox";
+export declare const EventTypeSchema: Type.TUnion<[Type.TLiteral<"immediate">, Type.TLiteral<"one-shot">, Type.TLiteral<"periodic">]>;
+export declare function validateEventFilename(filename: string): string;
+export declare function parseEventPayload(content: string, filename: string): EventFilePayload;
+export declare function buildEventPayload(input: EventPayloadInput): EventFilePayload;
+export declare function upcomingRuns(schedule: string, timezone: string, count: number): Date[];
+import type { Office } from "../office/types.js";
+export declare function officeEventsDir(office: Office): string;
+export declare class OfficeEventStore implements EventStore {
+    private readonly office;
+    private readonly scheduler?;
+    readonly address: OfficeAddress;
+    private readonly eventsDir;
+    constructor(office: Office, scheduler?: EventScheduleSink | undefined);
+    create(filename: string, payload: EventPayload): Promise<{
+        path: string;
+        size: number;
+    }>;
+    list(): Promise<Array<Omit<EventRecord, "payload"> & {
+        payload: EventPayload | null;
+    }>>;
+    read(filename: string): Promise<EventRecord>;
+    update(filename: string, payload: EventPayload): Promise<{
+        path: string;
+        size: number;
+    }>;
+    delete(filename: string): Promise<void>;
+    private assertOwnPayload;
+    private writeRecord;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

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

package/dist/events/index.js

@@ -0,0 +1,252 @@
+import { Cron } from "croner";
+import { errorMessage } from "../unknown-values.js";
+import { Type } from "typebox";
+import { parseJsonSchemaValue } from "../file-guards.js";
+export const EventTypeSchema = Type.Union([
+    Type.Literal("immediate"),
+    Type.Literal("one-shot"),
+    Type.Literal("periodic"),
+]);
+const EventFileSchema = Type.Object({
+    type: Type.Optional(EventTypeSchema),
+    platform: Type.Optional(Type.String()),
+    conversationId: Type.Optional(Type.String()),
+    channelId: Type.Optional(Type.String()),
+    conversationKind: Type.Optional(Type.Union([Type.Literal("direct"), Type.Literal("shared")])),
+    userId: Type.Optional(Type.String()),
+    text: Type.Optional(Type.String()),
+    at: Type.Optional(Type.String()),
+    schedule: Type.Optional(Type.String()),
+    timezone: Type.Optional(Type.String()),
+});
+const ISO_TIMESTAMP_WITH_OFFSET = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?(Z|[+-](\d{2}):(\d{2}))$/;
+function daysInMonth(year, month) {
+    if (month === 2) {
+        const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+        return leapYear ? 29 : 28;
+    }
+    return month === 4 || month === 6 || month === 9 || month === 11 ? 30 : 31;
+}
+export function validateEventFilename(filename) {
+    const trimmed = filename.trim();
+    if (!trimmed ||
+        trimmed.includes("/") ||
+        trimmed.includes("\\") ||
+        trimmed.includes("..") ||
+        !trimmed.endsWith(".json")) {
+        throw new Error("Invalid event filename");
+    }
+    return trimmed;
+}
+function isValidIsoTimestampWithOffset(value) {
+    const match = ISO_TIMESTAMP_WITH_OFFSET.exec(value);
+    if (!match)
+        return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    const hour = Number(match[4]);
+    const minute = Number(match[5]);
+    const second = match[6] === undefined ? 0 : Number(match[6]);
+    const offsetHour = match[8] === undefined ? 0 : Number(match[8]);
+    const offsetMinute = match[9] === undefined ? 0 : Number(match[9]);
+    return (month >= 1 &&
+        month <= 12 &&
+        day >= 1 &&
+        day <= daysInMonth(year, month) &&
+        hour >= 0 &&
+        hour <= 23 &&
+        minute >= 0 &&
+        minute <= 59 &&
+        second >= 0 &&
+        second <= 59 &&
+        offsetHour >= 0 &&
+        offsetHour <= 23 &&
+        offsetMinute >= 0 &&
+        offsetMinute <= 59 &&
+        Number.isFinite(Date.parse(value)));
+}
+export function parseEventPayload(content, filename) {
+    const data = parseJsonSchemaValue(content, EventFileSchema, (detail, kind) => kind === "shape"
+        ? `Expected top-level JSON object in ${filename}`
+        : `Malformed event file ${filename}: ${detail}`);
+    const conversationId = typeof data.conversationId === "string"
+        ? data.conversationId
+        : typeof data.channelId === "string"
+            ? data.channelId
+            : undefined;
+    const { type, text } = data;
+    if (!type || !conversationId || !text) {
+        throw new Error(`Missing required fields (type, conversationId, text) in ${filename}`);
+    }
+    const base = {
+        platform: data.platform,
+        conversationId,
+        conversationKind: data.conversationKind,
+        userId: data.userId,
+        text,
+    };
+    switch (type) {
+        case "immediate":
+            return { type, ...base };
+        case "one-shot":
+            if (typeof data.at !== "string" || data.at.length === 0) {
+                throw new Error(`Missing 'at' field for one-shot event in ${filename}`);
+            }
+            if (!isValidIsoTimestampWithOffset(data.at)) {
+                throw new Error(`Invalid 'at' field for one-shot event in ${filename}: expected a valid ISO 8601 timestamp with UTC offset`);
+            }
+            return { type, ...base, at: data.at };
+        case "periodic":
+            if (typeof data.schedule !== "string" || data.schedule.length === 0) {
+                throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);
+            }
+            if (typeof data.timezone !== "string" || data.timezone.length === 0) {
+                throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);
+            }
+            return { type, ...base, schedule: data.schedule, timezone: data.timezone };
+    }
+}
+export function buildEventPayload(input) {
+    const base = {
+        platform: input.platform,
+        conversationId: input.conversationId,
+        conversationKind: input.conversationKind,
+        userId: input.userId,
+        text: input.text,
+    };
+    switch (input.type) {
+        case "immediate":
+            return { type: "immediate", ...base };
+        case "one-shot": {
+            if (!input.at) {
+                throw new Error("`at` is required for one-shot events");
+            }
+            if (!isValidIsoTimestampWithOffset(input.at)) {
+                throw new Error("`at` must be a valid ISO 8601 timestamp with UTC offset");
+            }
+            return { type: "one-shot", ...base, at: input.at };
+        }
+        case "periodic":
+            if (!input.schedule) {
+                throw new Error("`schedule` is required for periodic events");
+            }
+            if (!input.timezone) {
+                throw new Error("`timezone` is required for periodic events");
+            }
+            upcomingRuns(input.schedule, input.timezone, 1);
+            return { type: "periodic", ...base, schedule: input.schedule, timezone: input.timezone };
+    }
+}
+export function upcomingRuns(schedule, timezone, count) {
+    try {
+        return new Cron(schedule, { timezone, paused: true }).nextRuns(count);
+    }
+    catch (error) {
+        throw new Error(`Invalid cron \`schedule\` "${schedule}" or \`timezone\` "${timezone}": ${errorMessage(error)}`, { cause: error });
+    }
+}
+import { existsSync } from "node:fs";
+import { mkdir, readdir, readFile, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { atomicWritePrivateFile } from "../file-guards.js";
+export function officeEventsDir(office) {
+    return join(office.stateDir, "events");
+}
+export class OfficeEventStore {
+    constructor(office, scheduler) {
+        this.office = office;
+        this.scheduler = scheduler;
+        this.address = office.address;
+        this.eventsDir = officeEventsDir(office);
+    }
+    async create(filename, payload) {
+        const safeFilename = validateEventFilename(filename);
+        this.assertOwnPayload(payload);
+        const filePath = join(this.eventsDir, safeFilename);
+        if (existsSync(filePath)) {
+            throw new Error(`Event ${safeFilename} already exists`);
+        }
+        return this.writeRecord(safeFilename, payload);
+    }
+    async list() {
+        if (!existsSync(this.eventsDir))
+            return [];
+        const entries = await readdir(this.eventsDir, { withFileTypes: true });
+        const events = await Promise.all(entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+            .map(async (entry) => {
+            try {
+                return await this.read(entry.name);
+            }
+            catch {
+                try {
+                    const fileStat = await stat(join(this.eventsDir, entry.name));
+                    return {
+                        filename: entry.name,
+                        payload: null,
+                        size: fileStat.size,
+                        mtimeMs: fileStat.mtimeMs,
+                    };
+                }
+                catch {
+                    return null;
+                }
+            }
+        }));
+        return events
+            .filter((event) => event !== null)
+            .toSorted((a, b) => a.filename.localeCompare(b.filename));
+    }
+    async read(filename) {
+        const safeFilename = validateEventFilename(filename);
+        const filePath = join(this.eventsDir, safeFilename);
+        if (!existsSync(filePath)) {
+            throw new Error(`Event ${safeFilename} not found in the current office`);
+        }
+        const [raw, fileStat] = await Promise.all([readFile(filePath, "utf-8"), stat(filePath)]);
+        return {
+            filename: safeFilename,
+            payload: parseEventPayload(raw, safeFilename),
+            size: fileStat.size,
+            mtimeMs: fileStat.mtimeMs,
+        };
+    }
+    async update(filename, payload) {
+        const safeFilename = validateEventFilename(filename);
+        this.assertOwnPayload(payload);
+        if (!existsSync(join(this.eventsDir, safeFilename))) {
+            throw new Error(`Event ${safeFilename} not found in the current office`);
+        }
+        return this.writeRecord(safeFilename, payload);
+    }
+    async delete(filename) {
+        const safeFilename = validateEventFilename(filename);
+        const filePath = join(this.eventsDir, safeFilename);
+        if (!existsSync(filePath)) {
+            throw new Error(`Event ${safeFilename} not found in the current office`);
+        }
+        this.scheduler?.cancelRecord(this.address, safeFilename);
+        await rm(filePath, { force: true });
+    }
+    assertOwnPayload(payload) {
+        if (payload.platform !== this.address.platform ||
+            payload.conversationId !== this.address.conversationId) {
+            throw new Error("Event payload must address the current office");
+        }
+    }
+    async writeRecord(safeFilename, payload) {
+        await mkdir(this.eventsDir, { recursive: true, mode: 0o700 });
+        const filePath = join(this.eventsDir, safeFilename);
+        atomicWritePrivateFile(filePath, JSON.stringify(payload) + "\n");
+        const fileStat = await stat(filePath);
+        this.scheduler?.scheduleRecord(this.address, {
+            filename: safeFilename,
+            payload,
+            size: fileStat.size,
+            mtimeMs: fileStat.mtimeMs,
+        });
+        return { path: filePath, size: fileStat.size };
+    }
+}
+//# sourceMappingURL=index.js.map