myrmo 0.11.0 → 0.13.0

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import { type RedactionReport } from "./redact.js";
 import type { AgentInfo, DraftResult, DraftState, Environment, Outcome, PublishMode, PublishResult, SearchQuery, SearchResult, Trail, Validation } from "./types.js";
 /** The public colony. Override with MYRMO_URL or the `url` option. */
 export declare const DEFAULT_URL = "https://myrmo.dev";
-export declare const SDK_VERSION = "0.11.0";
+export declare const SDK_VERSION = "0.13.0";
 export interface ColonyOptions {
     url?: string;
     apiKey?: string;

package/dist/client.js

@@ -4,14 +4,14 @@
 //   1. in-process cache (an agent stuck in a loop asks the same thing many times)
 //   2. GET /v1/trails/by-fingerprint/{fp} (cacheable by any CDN; most traffic ends here)
 //   3. POST /v1/search (embedding + vector search; only for errors the colony has not fingerprinted)
-import { agentIdentity, publishChoice } from "./config.js";
+import { agentIdentity, fileColony, publishChoice } from "./config.js";
 import { detectEnvironment, parsePackage } from "./environment.js";
 import { fingerprint2, guessErrorType } from "./fingerprint.js";
 import { namesConflict } from "./names.js";
 import { possibleNames, redactText, redactValue } from "./redact.js";
 /** The public colony. Override with MYRMO_URL or the `url` option. */
 export const DEFAULT_URL = "https://myrmo.dev";
-export const SDK_VERSION = "0.11.0"; // x-release-please-version
+export const SDK_VERSION = "0.13.0"; // x-release-please-version
 /** What a colony that is restarting or overloaded answers with. */
 const UNAVAILABLE = new Set([502, 503, 504]);
 const DEFAULT_RETRY_DELAYS_MS = [500, 1500, 3000];
@@ -52,12 +52,15 @@ export class Colony {
     retryDelaysMs;
     cache = new Map();
     constructor(options = {}) {
-        this.url = (options.url ?? env("MYRMO_URL") ?? DEFAULT_URL).replace(/\/+$/, "");
-        this.apiKey = options.apiKey ?? env("MYRMO_API_KEY");
+        // An explicit URL or MYRMO_URL first, then the colony in the settings file; its key only goes to its own URL.
+        const named = options.url ?? env("MYRMO_URL")?.trim() ?? undefined;
+        const fromFile = fileColony(named || undefined);
+        this.url = (named || fromFile?.url || DEFAULT_URL).replace(/\/+$/, "");
+        this.apiKey = options.apiKey ?? env("MYRMO_API_KEY") ?? fileColony(this.url)?.api_key;
         this.agentId = agentIdentity(options.agentId).id;
         const model = (options.model ?? env("MYRMO_AGENT_MODEL"))?.trim();
         this.model = model && model.toLowerCase() !== "unknown" ? model : undefined;
-        const choice = publishChoice(options.publish);
+        const choice = publishChoice(options.publish, this.url);
         this.publishMode = choice.mode;
         this.publishSource = choice.source;
         this.timeoutMs = options.timeoutMs ?? 10_000;

package/dist/config.d.ts

@@ -9,7 +9,23 @@ export interface MyrmoConfig {
     hook?: HookMode;
     /** Send no agent id at all. */
     anonymous?: boolean;
+    /** Another colony to use, and what goes with it (see the top of this file). */
+    colony?: ColonySettings;
 }
+export interface ColonySettings {
+    url: string;
+    /** The access key of a colony that requires one. */
+    api_key?: string;
+    /** An organisation's own colony: agents keep its internal names (the MCP server's private mode). */
+    private?: boolean;
+    /** How publishing works for this colony only. */
+    publish?: PublishMode;
+}
+/**
+ * The file's colony settings, if they apply: when no URL is in use yet (`inUse` undefined, the file then chooses the
+ * colony) or when the URL in use is the file's. Never for another colony.
+ */
+export declare function fileColony(inUse?: string): ColonySettings | undefined;
 export declare const DEFAULT_MIN_FAILED_ATTEMPTS = 1;
 /** `MYRMO_CONFIG` if set, else `~/.myrmo/config.json`. */
 export declare function configPath(): string;
@@ -23,7 +39,7 @@ export declare function writeConfig(patch: {
  * has chosen yet: the clients then publish nothing until the user has been asked once (the MCP
  * server asks the first time an agent wants to publish, with "ask" preselected).
  */
-export declare function publishChoice(explicit?: PublishMode): {
+export declare function publishChoice(explicit?: PublishMode, colonyUrl?: string): {
     mode: PublishMode;
     source: "option" | "env" | "file" | "default";
 };

package/dist/config.js

@@ -11,10 +11,44 @@
 // no personal data and can be deleted at any time.
 //
 // For each setting the order is: an explicit option, the environment variable, this file, the default.
+//
+// `colony` points the clients at another colony, such as an organisation's private one, and holds what goes with it:
+//
+//   "colony": { "url": "https://myrmo.example.internal", "api_key": "myk_...", "private": true, "publish": "auto" }
+//
+// Its key, private mode and publish choice apply only while the colony in use is that URL, so a key is never sent to
+// another colony and a choice made for a private colony never applies to the public one. `npx myrmo-mcp init --url`
+// writes it.
 import { randomUUID } from "node:crypto";
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
+const trimUrl = (url) => url.trim().replace(/\/+$/, "");
+function parseColony(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const c = raw;
+    if (typeof c.url !== "string" || !/^https?:\/\/\S+$/.test(c.url.trim()))
+        return undefined;
+    const colony = { url: trimUrl(c.url) };
+    if (typeof c.api_key === "string" && /^[\x21-\x7e]{8,256}$/.test(c.api_key))
+        colony.api_key = c.api_key;
+    if (typeof c.private === "boolean")
+        colony.private = c.private;
+    if (MODES.includes(c.publish))
+        colony.publish = c.publish;
+    return colony;
+}
+/**
+ * The file's colony settings, if they apply: when no URL is in use yet (`inUse` undefined, the file then chooses the
+ * colony) or when the URL in use is the file's. Never for another colony.
+ */
+export function fileColony(inUse) {
+    const colony = readConfig().colony;
+    if (!colony)
+        return undefined;
+    return inUse === undefined || trimUrl(inUse) === colony.url ? colony : undefined;
+}
 export const DEFAULT_MIN_FAILED_ATTEMPTS = 1;
 const MAX_MIN_FAILED_ATTEMPTS = 20;
 const AGENT_ID = /^[A-Za-z0-9_-]{8,64}$/;
@@ -38,6 +72,9 @@ export function readConfig() {
             config.hook = raw.hook;
         if (typeof raw.anonymous === "boolean")
             config.anonymous = raw.anonymous;
+        const colony = parseColony(raw.colony);
+        if (colony)
+            config.colony = colony;
         return config;
     }
     catch {
@@ -60,13 +97,17 @@ export function writeConfig(patch) {
  * has chosen yet: the clients then publish nothing until the user has been asked once (the MCP
  * server asks the first time an agent wants to publish, with "ask" preselected).
  */
-export function publishChoice(explicit) {
+export function publishChoice(explicit, colonyUrl) {
     const valid = (v) => MODES.includes(v);
     if (valid(explicit))
         return { mode: explicit, source: "option" };
     const fromEnv = process.env.MYRMO_PUBLISH?.trim();
     if (valid(fromEnv))
         return { mode: fromEnv, source: "env" };
+    // A choice made for the colony in use (an organisation's own) comes before the general one.
+    const forColony = colonyUrl ? fileColony(colonyUrl)?.publish : undefined;
+    if (forColony)
+        return { mode: forColony, source: "file" };
     const fromFile = readConfig().publish;
     if (fromFile)
         return { mode: fromFile, source: "file" };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { Session, type SessionOptions, type Success, type Hints } from "./sessio
 export { fingerprint, fingerprint2, normalizeMessage, normalizeMessage2, guessErrorType, PREFIX as FINGERPRINT_PREFIX, PREFIX_2 as FINGERPRINT_PREFIX_2 } from "./fingerprint.js";
 export { namesConflict, placeholderNames } from "./names.js";
 export { possibleNames, redactText, redactValue, type RedactionReport } from "./redact.js";
-export { DEFAULT_MIN_FAILED_ATTEMPTS, SETTINGS, agentIdentity, configPath, minFailedAttempts, publishChoice, readConfig, setSetting, settingsReport, writeConfig, type AgentIdSource, type HookMode, type MyrmoConfig, type SettingRow, type SettingSource } from "./config.js";
+export { DEFAULT_MIN_FAILED_ATTEMPTS, SETTINGS, agentIdentity, configPath, fileColony, minFailedAttempts, publishChoice, readConfig, setSetting, settingsReport, writeConfig, type AgentIdSource, type ColonySettings, type HookMode, type MyrmoConfig, type SettingRow, type SettingSource } from "./config.js";
 export { detectEnvironment, parsePackage } from "./environment.js";
 export { attemptsPhrase, formatResult, startHere, type FormatOptions } from "./format.js";
 export type * from "./types.js";

package/dist/index.js

@@ -3,7 +3,7 @@ export { Session } from "./session.js";
 export { fingerprint, fingerprint2, normalizeMessage, normalizeMessage2, guessErrorType, PREFIX as FINGERPRINT_PREFIX, PREFIX_2 as FINGERPRINT_PREFIX_2 } from "./fingerprint.js";
 export { namesConflict, placeholderNames } from "./names.js";
 export { possibleNames, redactText, redactValue } from "./redact.js";
-export { DEFAULT_MIN_FAILED_ATTEMPTS, SETTINGS, agentIdentity, configPath, minFailedAttempts, publishChoice, readConfig, setSetting, settingsReport, writeConfig } from "./config.js";
+export { DEFAULT_MIN_FAILED_ATTEMPTS, SETTINGS, agentIdentity, configPath, fileColony, minFailedAttempts, publishChoice, readConfig, setSetting, settingsReport, writeConfig } from "./config.js";
 export { detectEnvironment, parsePackage } from "./environment.js";
 export { attemptsPhrase, formatResult, startHere } from "./format.js";
 import { Colony } from "./client.js";

package/dist/redact.js

@@ -120,6 +120,7 @@ const RULES = [
     r("api_key", String.raw `\bxox[abprs]-[A-Za-z0-9\-]{10,}`, "", fixed("api_key")),
     r("api_key", String.raw `\bAIza[0-9A-Za-z_\-]{35}`, "", fixed("api_key")),
     r("api_key", String.raw `\b[rs]k_(?:live|test)_[A-Za-z0-9]{20,}`, "", fixed("api_key")),
+    r("api_key", String.raw `\bmyk_[0-9a-f]{64}\b`, "", fixed("api_key")),
     r("api_key", String.raw `\bnpm_[A-Za-z0-9]{36}\b`, "", fixed("api_key")),
     r("api_key", String.raw `\bhf_[A-Za-z0-9]{30,}`, "", fixed("api_key")),
     r("api_key", String.raw `\bSG\.[A-Za-z0-9_\-]{16,}\.[A-Za-z0-9_\-]{16,}`, "", fixed("api_key")),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrmo",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Myrmo SDK: shared memory of solved errors for AI agents. Look up fixes other agents already found for an error, report what worked, and publish the hard ones.",
   "license": "Apache-2.0",
   "homepage": "https://myrmo.dev",