dominds 0.1.0

package/dist/evt-registry.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Module: evt-registry
+ *
+ * PubChan registry for managing dialog event streams.
+ * Maps dialog IDs to PubChans for real-time event streaming during dialog driving.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dialogEventRegistry = void 0;
+exports.postDialogEvent = postDialogEvent;
+exports.postDialogEventById = postDialogEventById;
+exports.createEvent = createEvent;
+const log_1 = require("./log");
+const evt_1 = require("./shared/evt");
+const time_1 = require("./shared/utils/time");
+class DialogEventRegistryImpl {
+    constructor() {
+        this.pubChans = new Map();
+        this.log = (0, log_1.createLogger)('evt-registry');
+    }
+    /**
+     * Get or create a PubChan for a specific dialog ID
+     */
+    getPubChan(dialogId) {
+        let chan = this.pubChans.get(dialogId.key());
+        if (chan === undefined) {
+            chan = (0, evt_1.createPubChan)();
+            this.pubChans.set(dialogId.key(), chan);
+        }
+        return chan;
+    }
+    /**
+     * Create a SubChan for a specific dialog ID
+     */
+    createSubChan(dialogId) {
+        const pubChan = this.getPubChan(dialogId);
+        return (0, evt_1.createSubChan)(pubChan);
+    }
+    /**
+     * Remove PubChan for a dialog
+     */
+    removePubChan(dialogId) {
+        this.pubChans.delete(dialogId.key());
+    }
+    /**
+     * Create a TypedDialogEvent with common metadata (dialog info and timestamp)
+     */
+    createTypedEvent(dialogId, event) {
+        return {
+            dialog: {
+                selfId: dialogId.selfId,
+                rootId: dialogId.rootId,
+            },
+            timestamp: (0, time_1.formatUnifiedTimestamp)(new Date()),
+            ...event,
+        };
+    }
+    /**
+     * Post an event to the appropriate PubChan with proper hierarchy information
+     */
+    postEvent(dlg, event) {
+        const typedEvent = this.createTypedEvent(dlg.id, event);
+        const chan = this.getPubChan(dlg.id);
+        chan.write(typedEvent);
+    }
+    /**
+     * End-of-stream for a specific dialog
+     */
+    endStream(dialogId) {
+        const chan = this.pubChans.get(dialogId.key());
+        if (chan) {
+            chan.write(evt_1.EndOfStream);
+        }
+    }
+    /**
+     * Clean up all PubChans (for server shutdown)
+     */
+    cleanup() {
+        for (const chan of this.pubChans.values()) {
+            chan.write(evt_1.EndOfStream);
+        }
+        this.pubChans.clear();
+    }
+}
+// Export singleton instance
+exports.dialogEventRegistry = new DialogEventRegistryImpl();
+// Export helper function to import in other modules
+function postDialogEvent(dlg, event) {
+    exports.dialogEventRegistry.postEvent(dlg, event);
+}
+/**
+ * Post an event to a specific dialog's PubChan by ID.
+ * Useful for posting subdialog events when only the subdialog ID is available.
+ */
+function postDialogEventById(dialogId, event) {
+    const typedEvent = exports.dialogEventRegistry.createTypedEvent(dialogId, event);
+    const chan = exports.dialogEventRegistry.getPubChan(dialogId);
+    chan.write(typedEvent);
+}
+// Helper functions to create events with simpler API
+function createEvent(type) {
+    return { type };
+}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Module: index
+ *
+ * Package entry exports for `dominds`. Re-exports core modules and utilities.
+ *
+ * TODO: pre-release engineering task: cherrypick artefacts to re-export, as for dominds to be consumed as an sdk package
+ */

package/dist/llm/client.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmConfig = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+const log_1 = require("../log");
+/**
+ * LlmConfig
+ *
+ * Wraps provider configurations and exposes lookup helpers.
+ */
+class LlmConfig {
+    constructor(providers) {
+        this._providers = providers;
+    }
+    get providers() {
+        return this._providers;
+    }
+    getProvider(providerKey) {
+        return this._providers[providerKey];
+    }
+}
+exports.LlmConfig = LlmConfig;
+(function (LlmConfig) {
+    async function load() {
+        // Load default providers from YAML file
+        const defaultsPath = path_1.default.join(__dirname, 'defaults.yaml');
+        const rawDefaults = await promises_1.default.readFile(defaultsPath, 'utf-8');
+        const parsedDefaults = yaml_1.default.parse(rawDefaults);
+        if (!isRecord(parsedDefaults) || !isRecord(parsedDefaults.providers)) {
+            throw new Error('Invalid defaults.yaml: expected providers object');
+        }
+        const defaultProviders = parsedDefaults.providers;
+        // Load workspace configuration
+        const cfgPath = '.minds/llm.yaml';
+        let workspaceProviders = {};
+        try {
+            await promises_1.default.access(cfgPath);
+            try {
+                const raw = await promises_1.default.readFile(cfgPath, 'utf-8');
+                const parsed = yaml_1.default.parse(raw);
+                const providers = isRecord(parsed) ? parsed.providers : undefined;
+                if (isRecord(providers)) {
+                    workspaceProviders = providers;
+                }
+                else {
+                    throw new Error('Invalid llm.yaml: missing providers object');
+                }
+            }
+            catch (error) {
+                log_1.log.warn('Could not load workspace llm.yaml:', error);
+            }
+        }
+        catch (err) {
+            log_1.log.debug('No workspace llm.yaml found, using defaults');
+        }
+        // Merge defaults with workspace config (workspace overrides defaults)
+        const mergedProviders = { ...defaultProviders, ...workspaceProviders };
+        return new LlmConfig(mergedProviders);
+    }
+    LlmConfig.load = load;
+})(LlmConfig || (exports.LlmConfig = LlmConfig = {}));
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}

package/dist/llm/defaults.yaml

@@ -0,0 +1,386 @@
+providers:
+  codex:
+    name: Codex (ChatGPT)
+    apiType: codex
+    baseUrl: https://chatgpt.com/backend-api/
+    apiKeyEnvVar: CODEX_HOME
+    tech_spec_url: https://platform.openai.com/docs/api-reference/responses
+    api_mgmt_url: https://chatgpt.com/
+    # `model_param_options` documents common `.minds/team.yaml` `model_params` fields
+    # that this provider supports (as of this defaults.yaml).
+    #
+    # These are documentation hints for humans/agents; they are not auto-applied.
+    model_param_options:
+      general:
+        max_tokens:
+          # Provider-agnostic cap on generated tokens.
+          type: integer
+          min: 1
+          description: Maximum tokens to generate (provider-agnostic override).
+      codex:
+        reasoning_effort:
+          prominent: true
+          default: high
+          # Trade latency/cost for quality on reasoning-capable models.
+          # Allowed: none | minimal | low | medium | high | xhigh
+          type: enum
+          values: [none, minimal, low, medium, high, xhigh]
+          description: Reasoning effort level (when supported by the model).
+        verbosity:
+          prominent: true
+          default: medium
+          # Control response detail level on GPT-5 series models.
+          # Allowed: low | medium | high
+          type: enum
+          values: [low, medium, high]
+          description: Response verbosity/detail level (GPT-5 series).
+        temperature:
+          # Randomness; use 0–0.2 for tool-calling / deterministic behavior.
+          type: number
+          min: 0
+          max: 2
+          description: Sampling temperature (0–2).
+        top_p:
+          # Nucleus sampling; usually leave unset if using temperature.
+          type: number
+          min: 0
+          max: 1
+          description: Nucleus sampling probability (0–1).
+        parallel_tool_calls:
+          type: boolean
+          description: Allow the model to emit parallel tool calls (enable by default in Dominds).
+        max_tokens:
+          type: integer
+          min: 1
+          description: Provider-specific max tokens override.
+    models:
+      gpt-5.2-codex:
+        name: GPT-5.2 Codex
+        optimal_max_tokens: 200000
+        context_length: 272000
+        input_length: 272000
+        output_length: 32768
+        context_window: '272K'
+      gpt-5.2:
+        name: GPT-5.2
+        optimal_max_tokens: 200000
+        context_length: 272000
+        input_length: 272000
+        output_length: 32768
+        context_window: '272K'
+  minimaxi.com-coding-plan:
+    name: MiniMax CN Coding Plan
+    apiType: anthropic
+    baseUrl: https://api.minimaxi.com/anthropic
+    apiKeyEnvVar: MINIMAX_CN_CP_API_KEY
+    tech_spec_url: https://platform.minimaxi.com/document/guides
+    api_mgmt_url: https://platform.minimaxi.com/
+    models:
+      MiniMax-M2.1:
+        name: MiniMax M2.1
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+      MiniMax-M2:
+        name: MiniMax M2
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+  minimaxi.com:
+    name: MiniMax CN
+    apiType: anthropic
+    baseUrl: https://api.minimaxi.com/anthropic
+    apiKeyEnvVar: MINIMAX_CN_API_KEY
+    tech_spec_url: https://platform.minimaxi.com/document/guides
+    api_mgmt_url: https://platform.minimaxi.com/
+    models:
+      MiniMax-M2.1:
+        name: MiniMax M2.1
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+      MiniMax-M2:
+        name: MiniMax M2 Stable
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+  minimax.io-coding-plan:
+    name: MiniMax International Coding Plan
+    apiType: anthropic
+    baseUrl: https://api.minimax.io/anthropic
+    apiKeyEnvVar: MINIMAX_CP_API_KEY
+    tech_spec_url: https://platform.minimax.io/docs/api-reference
+    api_mgmt_url: https://platform.minimax.io/
+    models:
+      MiniMax-M2.1:
+        name: MiniMax M2.1
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+      MiniMax-M2:
+        name: MiniMax M2
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+  minimax.io:
+    name: MiniMax International
+    apiType: anthropic
+    baseUrl: https://api.minimax.io/anthropic
+    apiKeyEnvVar: MINIMAX_API_KEY
+    tech_spec_url: https://platform.minimax.io/docs/api-reference
+    api_mgmt_url: https://platform.minimax.io/
+    models:
+      MiniMax-M2.1:
+        name: MiniMax M2.1
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+      MiniMax-M2:
+        name: MiniMax M2 Stable
+        context_length: 204800
+        input_length: 204800
+        output_length: 8192
+        context_window: '204K'
+  bigmodel:
+    name: BigModel
+    apiType: anthropic
+    baseUrl: https://open.bigmodel.cn/api/anthropic
+    apiKeyEnvVar: ZHIPUAI_API_KEY
+    tech_spec_url: https://docs.bigmodel.cn/
+    api_mgmt_url: https://open.bigmodel.cn/usercenter/apikeys
+    models:
+      glm-4.7:
+        name: GLM-4.7
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K'
+      glm-4.6:
+        name: GLM-4.6
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K'
+      glm-4.5:
+        name: GLM-4.5
+        context_length: 128000
+        input_length: 128000
+        output_length: 8192
+        context_window: '128K'
+      glm-4.5-air:
+        name: GLM-4.5-Air
+        context_length: 128000
+        input_length: 128000
+        output_length: 8192
+        context_window: '128K'
+  z.ai:
+    name: Z.AI
+    apiType: anthropic
+    baseUrl: https://api.z.ai/api/anthropic
+    apiKeyEnvVar: ZAI_API_KEY
+    tech_spec_url: https://docs.z.ai/api-reference
+    api_mgmt_url: https://z.ai/manage-apikey/apikey-list
+    models:
+      glm-4.7:
+        name: GLM-4.7
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K'
+      glm-4.6:
+        name: GLM-4.6
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K'
+      glm-4.5:
+        name: GLM-4.5
+        context_length: 128000
+        input_length: 128000
+        output_length: 8192
+        context_window: '128K'
+      glm-4.5-air:
+        name: GLM-4.5-Air
+        context_length: 128000
+        input_length: 128000
+        output_length: 8192
+        context_window: '128K'
+  ark-coding-plan:
+    name: Ark Coding Plan
+    apiType: anthropic
+    baseUrl: https://ark.cn-beijing.volces.com/api/coding
+    apiKeyEnvVar: ARK_API_KEY
+    tech_spec_url: https://api.volcengine.com/api-docs/view?serviceCode=ark&version=2024-01-01
+    api_mgmt_url: https://console.volcengine.com/ark
+    models:
+      doubao-seed-code-preview-latest:
+        name: Doubao Seed Code Preview
+        context_length: 256000
+        input_length: 256000
+        output_length: 8192
+        context_window: '256K'
+        optimization: 专为Agentic Coding任务优化
+  ark:
+    name: Ark
+    apiType: openai
+    baseUrl: https://ark.cn-beijing.volces.com/api/v3
+    apiKeyEnvVar: ARK_API_KEY
+    tech_spec_url: https://api.volcengine.com/api-docs/view?serviceCode=ark&version=2024-01-01
+    api_mgmt_url: https://console.volcengine.com/ark
+    models:
+      deepseek-v3-2-251201:
+        name: DeepSeek-V3.2
+        context_length: 128000
+        input_length: 96000
+        output_length: 32000
+        context_window: '128K'
+      doubao-seed-code-preview-251028:
+        name: Doubao Seed Code Preview 251028
+        context_length: 256000
+        input_length: 256000
+        output_length: 8192
+        context_window: '256K'
+      doubao-seed-1-6-251015:
+        name: Doubao Seed 1.6
+        context_length: 256000
+        input_length: 256000
+        output_length: 8192
+        context_window: '256K'
+      doubao-seed-1-6-thinking-250715:
+        name: Doubao Seed 1.6 Thinking
+        context_length: 256000
+        input_length: 256000
+        output_length: 8192
+        context_window: '256K'
+      doubao-seed-1-6-lite-251015:
+        name: Doubao Seed 1.6 Lite
+        context_length: 32000
+        input_length: 32000
+        output_length: 8192
+        context_window: '32K'
+      kimi-k2-250905:
+        name: Kimi K2
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K (约20万汉字)'
+      deepseek-v3-1-terminus:
+        name: DeepSeek V3.1 Terminus
+        context_length: 131072
+        input_length: 131072
+        output_length: 8192
+        context_window: '128K'
+  anthropic:
+    name: Anthropic
+    apiType: anthropic
+    baseUrl: https://api.anthropic.com
+    apiKeyEnvVar: ANTHROPIC_API_KEY
+    tech_spec_url: https://docs.anthropic.com/en/docs
+    api_mgmt_url: https://console.anthropic.com/
+    model_param_options:
+      general:
+        max_tokens:
+          type: integer
+          min: 1
+          description: Maximum tokens to generate (provider-agnostic override).
+      anthropic:
+        temperature:
+          type: number
+          min: 0
+          max: 1
+          description: Sampling temperature (0–1).
+        top_p:
+          type: number
+          min: 0
+          max: 1
+          description: Nucleus sampling probability (0–1).
+        top_k:
+          type: integer
+          min: 0
+          description: Top-k sampling (0 disables).
+        max_tokens:
+          type: integer
+          min: 1
+          description: Provider-specific max tokens override.
+        stop_sequences:
+          type: string_array
+          description: Stop sequences (array of strings).
+        reasoning_split:
+          # If supported, streams a separated "thinking/reasoning" channel.
+          type: boolean
+          description: Enable separated reasoning stream (when supported).
+    models:
+      claude-opus-4.5:
+        name: Claude Opus 4.5
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K'
+      claude-sonnet-4.5:
+        name: Claude Sonnet 4.5
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K'
+      claude-haiku-4.5:
+        name: Claude Haiku 4.5
+        context_length: 200000
+        input_length: 200000
+        output_length: 8192
+        context_window: '200K'
+  openai:
+    name: OpenAI
+    apiType: openai
+    baseUrl: https://api.openai.com/v1
+    apiKeyEnvVar: OPENAI_API_KEY
+    tech_spec_url: https://platform.openai.com/docs
+    api_mgmt_url: https://platform.openai.com/api-keys
+    model_param_options:
+      general:
+        max_tokens:
+          type: integer
+          min: 1
+          description: Maximum tokens to generate (provider-agnostic override).
+      openai:
+        reasoning_effort:
+          type: enum
+          values: [none, minimal, low, medium, high, xhigh]
+          description: Reasoning effort level (when supported by the model).
+        verbosity:
+          type: enum
+          values: [low, medium, high]
+          description: Response verbosity/detail level (GPT-5 series).
+        temperature:
+          type: number
+          min: 0
+          max: 2
+          description: Sampling temperature (0–2).
+        top_p:
+          type: number
+          min: 0
+          max: 1
+          description: Nucleus sampling probability (0–1).
+        max_tokens:
+          type: integer
+          min: 1
+          description: Provider-specific max tokens override.
+    models:
+      gpt-5.2:
+        name: GPT-5.2
+        context_length: 272000
+        input_length: 272000
+        output_length: 32768
+        context_window: '272K'
+      gpt-5.2-codex:
+        name: GPT-5.2 Codex
+        context_length: 272000
+        input_length: 272000
+        output_length: 32768
+        context_window: '272K'