@evalops/maestro 0.10.18 → 0.10.21

package/dist/codex/subagent-workgraph.d.ts

@@ -0,0 +1,56 @@
+export declare const CODEX_SUBAGENT_TOOL_PREFIX = "codex.subagent.";
+export declare const CODEX_THREAD_CHILD_RUN_PREFIX = "codex-thread:";
+export declare const CODEX_SUBAGENT_WORK_GRAPH_SCHEMA = "evalops.maestro.codex.subagent-workgraph.v1";
+export type CodexSubagentCanonicalTool = "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent";
+export interface CodexSubagentLifecycleOperation {
+    tool: CodexSubagentCanonicalTool;
+    operation: string;
+    aliases: readonly string[];
+    activeStatus: string;
+    terminalSuccessStatus: string;
+    nextAction: string;
+}
+export declare const CODEX_SUBAGENT_LIFECYCLE_OPERATIONS: readonly [{
+    readonly tool: "spawnAgent";
+    readonly operation: "spawn_agent";
+    readonly aliases: readonly ["spawnAgent", "spawn_agent"];
+    readonly activeStatus: "waiting_for_restore";
+    readonly terminalSuccessStatus: "spawned";
+    readonly nextAction: "wait for child agent initialization or completion";
+}, {
+    readonly tool: "sendInput";
+    readonly operation: "send_input";
+    readonly aliases: readonly ["sendInput", "send_input"];
+    readonly activeStatus: "waiting_for_input_ack";
+    readonly terminalSuccessStatus: "acknowledged";
+    readonly nextAction: "wait for child agent response";
+}, {
+    readonly tool: "resumeAgent";
+    readonly operation: "resume_agent";
+    readonly aliases: readonly ["resumeAgent", "resumeSubagent", "resume_agent", "resume_subagent"];
+    readonly activeStatus: "restoring";
+    readonly terminalSuccessStatus: "resumed";
+    readonly nextAction: "wait for resumed child agent response";
+}, {
+    readonly tool: "wait";
+    readonly operation: "wait_agent";
+    readonly aliases: readonly ["wait", "waitAgent", "wait_agent"];
+    readonly activeStatus: "wait_pending";
+    readonly terminalSuccessStatus: "completed";
+    readonly nextAction: "wait for selected child agents";
+}, {
+    readonly tool: "closeAgent";
+    readonly operation: "close_agent";
+    readonly aliases: readonly ["closeAgent", "close_agent"];
+    readonly activeStatus: "waiting_for_close";
+    readonly terminalSuccessStatus: "closed";
+    readonly nextAction: "confirm child agent shutdown";
+}];
+export declare function codexSubagentLifecycleOperation(value: string | undefined): CodexSubagentLifecycleOperation | undefined;
+export declare function canonicalCodexSubagentTool(value: string | undefined): CodexSubagentCanonicalTool | undefined;
+export declare function codexSubagentOperationName(value: string | undefined): string | undefined;
+export declare function codexSubagentActiveStatus(value: string | undefined): string | undefined;
+export declare function codexSubagentTerminalSuccessStatus(value: string | undefined): string | undefined;
+export declare function codexSubagentNextAction(value: string | undefined): string | undefined;
+export declare function codexSubagentLifecycleOperationForTool(tool: CodexSubagentCanonicalTool): CodexSubagentLifecycleOperation;
+//# sourceMappingURL=subagent-workgraph.d.ts.map

package/dist/codex/subagent-workgraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-workgraph.d.ts","sourceRoot":"","sources":["../../src/codex/subagent-workgraph.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,oBAAoB,CAAC;AAC5D,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAC7D,eAAO,MAAM,gCAAgC,gDACC,CAAC;AAE/C,MAAM,MAAM,0BAA0B,GACnC,YAAY,GACZ,WAAW,GACX,aAAa,GACb,MAAM,GACN,YAAY,CAAC;AAEhB,MAAM,WAAW,+BAA+B;IAC/C,IAAI,EAAE,0BAA0B,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8Ce,CAAC;AA0BhE,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,+BAA+B,GAAG,SAAS,CAE7C;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,0BAA0B,GAAG,SAAS,CAExC;AAED,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,kCAAkC,CACjD,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,sCAAsC,CACrD,IAAI,EAAE,0BAA0B,GAC9B,+BAA+B,CAMjC"}

package/dist/codex/subagent-workgraph.js

@@ -0,0 +1,89 @@
+export const CODEX_SUBAGENT_TOOL_PREFIX = "codex.subagent.";
+export const CODEX_THREAD_CHILD_RUN_PREFIX = "codex-thread:";
+export const CODEX_SUBAGENT_WORK_GRAPH_SCHEMA = "evalops.maestro.codex.subagent-workgraph.v1";
+export const CODEX_SUBAGENT_LIFECYCLE_OPERATIONS = [
+    {
+        tool: "spawnAgent",
+        operation: "spawn_agent",
+        aliases: ["spawnAgent", "spawn_agent"],
+        activeStatus: "waiting_for_restore",
+        terminalSuccessStatus: "spawned",
+        nextAction: "wait for child agent initialization or completion",
+    },
+    {
+        tool: "sendInput",
+        operation: "send_input",
+        aliases: ["sendInput", "send_input"],
+        activeStatus: "waiting_for_input_ack",
+        terminalSuccessStatus: "acknowledged",
+        nextAction: "wait for child agent response",
+    },
+    {
+        tool: "resumeAgent",
+        operation: "resume_agent",
+        aliases: [
+            "resumeAgent",
+            "resumeSubagent",
+            "resume_agent",
+            "resume_subagent",
+        ],
+        activeStatus: "restoring",
+        terminalSuccessStatus: "resumed",
+        nextAction: "wait for resumed child agent response",
+    },
+    {
+        tool: "wait",
+        operation: "wait_agent",
+        aliases: ["wait", "waitAgent", "wait_agent"],
+        activeStatus: "wait_pending",
+        terminalSuccessStatus: "completed",
+        nextAction: "wait for selected child agents",
+    },
+    {
+        tool: "closeAgent",
+        operation: "close_agent",
+        aliases: ["closeAgent", "close_agent"],
+        activeStatus: "waiting_for_close",
+        terminalSuccessStatus: "closed",
+        nextAction: "confirm child agent shutdown",
+    },
+];
+const operationByAlias = new Map();
+const operationByCanonicalTool = new Map();
+for (const operation of CODEX_SUBAGENT_LIFECYCLE_OPERATIONS) {
+    operationByCanonicalTool.set(operation.tool, operation);
+    operationByAlias.set(operation.tool, operation);
+    operationByAlias.set(operation.operation, operation);
+    operationByAlias.set(`${CODEX_SUBAGENT_TOOL_PREFIX}${operation.tool}`, operation);
+    operationByAlias.set(`${CODEX_SUBAGENT_TOOL_PREFIX}${operation.operation}`, operation);
+    for (const alias of operation.aliases) {
+        operationByAlias.set(alias, operation);
+        operationByAlias.set(`${CODEX_SUBAGENT_TOOL_PREFIX}${alias}`, operation);
+    }
+}
+export function codexSubagentLifecycleOperation(value) {
+    return value ? operationByAlias.get(value) : undefined;
+}
+export function canonicalCodexSubagentTool(value) {
+    return codexSubagentLifecycleOperation(value)?.tool;
+}
+export function codexSubagentOperationName(value) {
+    return codexSubagentLifecycleOperation(value)?.operation;
+}
+export function codexSubagentActiveStatus(value) {
+    return codexSubagentLifecycleOperation(value)?.activeStatus;
+}
+export function codexSubagentTerminalSuccessStatus(value) {
+    return codexSubagentLifecycleOperation(value)?.terminalSuccessStatus;
+}
+export function codexSubagentNextAction(value) {
+    return codexSubagentLifecycleOperation(value)?.nextAction;
+}
+export function codexSubagentLifecycleOperationForTool(tool) {
+    const operation = operationByCanonicalTool.get(tool);
+    if (!operation) {
+        throw new Error(`Unknown Codex subagent tool ${tool}`);
+    }
+    return operation;
+}
+//# sourceMappingURL=subagent-workgraph.js.map

package/dist/codex/subagent-workgraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-workgraph.js","sourceRoot":"","sources":["../../src/codex/subagent-workgraph.ts"],"names":[],"mappings":"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","sourcesContent":["export const CODEX_SUBAGENT_TOOL_PREFIX = \"codex.subagent.\";\nexport const CODEX_THREAD_CHILD_RUN_PREFIX = \"codex-thread:\";\nexport const CODEX_SUBAGENT_WORK_GRAPH_SCHEMA =\n\t\"evalops.maestro.codex.subagent-workgraph.v1\";\n\nexport type CodexSubagentCanonicalTool =\n\t| \"spawnAgent\"\n\t| \"sendInput\"\n\t| \"resumeAgent\"\n\t| \"wait\"\n\t| \"closeAgent\";\n\nexport interface CodexSubagentLifecycleOperation {\n\ttool: CodexSubagentCanonicalTool;\n\toperation: string;\n\taliases: readonly string[];\n\tactiveStatus: string;\n\tterminalSuccessStatus: string;\n\tnextAction: string;\n}\n\nexport const CODEX_SUBAGENT_LIFECYCLE_OPERATIONS = [\n\t{\n\t\ttool: \"spawnAgent\",\n\t\toperation: \"spawn_agent\",\n\t\taliases: [\"spawnAgent\", \"spawn_agent\"],\n\t\tactiveStatus: \"waiting_for_restore\",\n\t\tterminalSuccessStatus: \"spawned\",\n\t\tnextAction: \"wait for child agent initialization or completion\",\n\t},\n\t{\n\t\ttool: \"sendInput\",\n\t\toperation: \"send_input\",\n\t\taliases: [\"sendInput\", \"send_input\"],\n\t\tactiveStatus: \"waiting_for_input_ack\",\n\t\tterminalSuccessStatus: \"acknowledged\",\n\t\tnextAction: \"wait for child agent response\",\n\t},\n\t{\n\t\ttool: \"resumeAgent\",\n\t\toperation: \"resume_agent\",\n\t\taliases: [\n\t\t\t\"resumeAgent\",\n\t\t\t\"resumeSubagent\",\n\t\t\t\"resume_agent\",\n\t\t\t\"resume_subagent\",\n\t\t],\n\t\tactiveStatus: \"restoring\",\n\t\tterminalSuccessStatus: \"resumed\",\n\t\tnextAction: \"wait for resumed child agent response\",\n\t},\n\t{\n\t\ttool: \"wait\",\n\t\toperation: \"wait_agent\",\n\t\taliases: [\"wait\", \"waitAgent\", \"wait_agent\"],\n\t\tactiveStatus: \"wait_pending\",\n\t\tterminalSuccessStatus: \"completed\",\n\t\tnextAction: \"wait for selected child agents\",\n\t},\n\t{\n\t\ttool: \"closeAgent\",\n\t\toperation: \"close_agent\",\n\t\taliases: [\"closeAgent\", \"close_agent\"],\n\t\tactiveStatus: \"waiting_for_close\",\n\t\tterminalSuccessStatus: \"closed\",\n\t\tnextAction: \"confirm child agent shutdown\",\n\t},\n] as const satisfies readonly CodexSubagentLifecycleOperation[];\n\nconst operationByAlias = new Map<string, CodexSubagentLifecycleOperation>();\nconst operationByCanonicalTool = new Map<\n\tCodexSubagentCanonicalTool,\n\tCodexSubagentLifecycleOperation\n>();\n\nfor (const operation of CODEX_SUBAGENT_LIFECYCLE_OPERATIONS) {\n\toperationByCanonicalTool.set(operation.tool, operation);\n\toperationByAlias.set(operation.tool, operation);\n\toperationByAlias.set(operation.operation, operation);\n\toperationByAlias.set(\n\t\t`${CODEX_SUBAGENT_TOOL_PREFIX}${operation.tool}`,\n\t\toperation,\n\t);\n\toperationByAlias.set(\n\t\t`${CODEX_SUBAGENT_TOOL_PREFIX}${operation.operation}`,\n\t\toperation,\n\t);\n\tfor (const alias of operation.aliases) {\n\t\toperationByAlias.set(alias, operation);\n\t\toperationByAlias.set(`${CODEX_SUBAGENT_TOOL_PREFIX}${alias}`, operation);\n\t}\n}\n\nexport function codexSubagentLifecycleOperation(\n\tvalue: string | undefined,\n): CodexSubagentLifecycleOperation | undefined {\n\treturn value ? operationByAlias.get(value) : undefined;\n}\n\nexport function canonicalCodexSubagentTool(\n\tvalue: string | undefined,\n): CodexSubagentCanonicalTool | undefined {\n\treturn codexSubagentLifecycleOperation(value)?.tool;\n}\n\nexport function codexSubagentOperationName(\n\tvalue: string | undefined,\n): string | undefined {\n\treturn codexSubagentLifecycleOperation(value)?.operation;\n}\n\nexport function codexSubagentActiveStatus(\n\tvalue: string | undefined,\n): string | undefined {\n\treturn codexSubagentLifecycleOperation(value)?.activeStatus;\n}\n\nexport function codexSubagentTerminalSuccessStatus(\n\tvalue: string | undefined,\n): string | undefined {\n\treturn codexSubagentLifecycleOperation(value)?.terminalSuccessStatus;\n}\n\nexport function codexSubagentNextAction(\n\tvalue: string | undefined,\n): string | undefined {\n\treturn codexSubagentLifecycleOperation(value)?.nextAction;\n}\n\nexport function codexSubagentLifecycleOperationForTool(\n\ttool: CodexSubagentCanonicalTool,\n): CodexSubagentLifecycleOperation {\n\tconst operation = operationByCanonicalTool.get(tool);\n\tif (!operation) {\n\t\tthrow new Error(`Unknown Codex subagent tool ${tool}`);\n\t}\n\treturn operation;\n}\n"]}

package/dist/config/constants.d.ts

@@ -46,6 +46,8 @@ export declare const PATHS: {
     readonly TOOL_FAILURE_LOG: string;
     /** Project MCP approval decisions */
     readonly MCP_PROJECT_APPROVALS_FILE: string;
+    /** Per-workspace MCP invocation trust decisions */
+    readonly MCP_WORKSPACE_TRUST_FILE: string;
     /** Project onboarding state */
     readonly PROJECT_ONBOARDING_FILE: string;
     /** TUI keybinding overrides */
@@ -71,7 +73,7 @@ export declare const PATHS: {
     /** Cost tracking database path */
     readonly COST_DB: string;
     /** Agent context files */
-    readonly AGENT_CONTEXT_FILES: readonly ["AGENTS.override.md", "AGENTS.md", "AGENT.md", "CLAUDE.md"];
+    readonly AGENT_CONTEXT_FILES: readonly ["AGENTS.override.md", "AGENTS.md", "Agents.md", "agents.md", "AGENT.md", "Agent.md", "agent.md", "CLAUDE.md"];
 };
 /**
  * API and network configuration

package/dist/config/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,eAAe,QAAO,MACwC,CAAC;AAE5E,eAAO,MAAM,WAAW,QAAO,MAM9B,CAAC;AASF;;GAEG;AACH,eAAO,MAAM,cAAc;IAC1B,0DAA0D;;IAK1D,qCAAqC;0BAClB,MAAM;IAMzB,iFAAiF;;IAEjF,uDAAuD;;CAK9C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;IACvB,0DAA0D;;IAK1D,sCAAsC;;IAEtC,+CAA+C;;CAEtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB,8BAA8B;2BACV,MAAM;IAG1B,2BAA2B;yBACT,MAAM;IAMxB,+BAA+B;yBACb,MAAM;IAMxB,8BAA8B;4BACT,MAAM;IAM3B,iCAAiC;+BACT,MAAM;IAG9B,qCAAqC;yCACH,MAAM;IAMxC,+BAA+B;sCACA,MAAM;IAMrC,+BAA+B;mCACH,MAAM;IAMlC,oCAAoC;sCACL,MAAM;IAGrC,yBAAyB;4BACJ,MAAM;IAM3B,8BAA8B;iCACJ,MAAM;IAMhC,gCAAgC;mCACJ,MAAM;IAMlC,6BAA6B;gCACJ,MAAM;IAM/B,+BAA+B;kCACJ,MAAM;IAMjC,6BAA6B;gCACJ,MAAM;IAM/B,8BAA8B;wBACb,MAAM;IAGvB,8BAA8B;gCACL,MAAM;IAM/B,kCAAkC;sBACnB,MAAM;IAMrB,0BAA0B;;CAOjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACtB,0DAA0D;;IAK1D,oCAAoC;;CAI3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;IAClB,2CAA2C;;IAK3C,uCAAuC;;IAKvC,iDAAiD;;IAEjD,kCAAkC;;CAEzB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACpB,wDAAwD;;IAExD,2DAA2D;;IAE3D,uBAAuB;;IAEvB,6BAA6B;;IAE7B,6BAA6B;;IAE7B,0CAA0C;;CAEjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACtB,kDAAkD;;CAuBzC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;CAOT,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,eAAe,QAAO,MACwC,CAAC;AAE5E,eAAO,MAAM,WAAW,QAAO,MAM9B,CAAC;AASF;;GAEG;AACH,eAAO,MAAM,cAAc;IAC1B,0DAA0D;;IAK1D,qCAAqC;0BAClB,MAAM;IAMzB,iFAAiF;;IAEjF,uDAAuD;;CAK9C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;IACvB,0DAA0D;;IAK1D,sCAAsC;;IAEtC,+CAA+C;;CAEtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;IACjB,8BAA8B;2BACV,MAAM;IAG1B,2BAA2B;yBACT,MAAM;IAMxB,+BAA+B;yBACb,MAAM;IAMxB,8BAA8B;4BACT,MAAM;IAM3B,iCAAiC;+BACT,MAAM;IAG9B,qCAAqC;yCACH,MAAM;IAMxC,mDAAmD;uCACnB,MAAM;IAMtC,+BAA+B;sCACA,MAAM;IAMrC,+BAA+B;mCACH,MAAM;IAMlC,oCAAoC;sCACL,MAAM;IAGrC,yBAAyB;4BACJ,MAAM;IAM3B,8BAA8B;iCACJ,MAAM;IAMhC,gCAAgC;mCACJ,MAAM;IAMlC,6BAA6B;gCACJ,MAAM;IAM/B,+BAA+B;kCACJ,MAAM;IAMjC,6BAA6B;gCACJ,MAAM;IAM/B,8BAA8B;wBACb,MAAM;IAGvB,8BAA8B;gCACL,MAAM;IAM/B,kCAAkC;sBACnB,MAAM;IAMrB,0BAA0B;;CAWjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACtB,0DAA0D;;IAK1D,oCAAoC;;CAI3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;IAClB,2CAA2C;;IAK3C,uCAAuC;;IAKvC,iDAAiD;;IAEjD,kCAAkC;;CAEzB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACpB,wDAAwD;;IAExD,2DAA2D;;IAE3D,uBAAuB;;IAEvB,6BAA6B;;IAE7B,6BAA6B;;IAE7B,0CAA0C;;CAEjC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACtB,kDAAkD;;CAuBzC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;CAOT,CAAC"}

package/dist/config/constants.js

@@ -79,6 +79,11 @@ export const PATHS = {
         return (resolveEnvPath(process.env.MAESTRO_MCP_PROJECT_APPROVALS_FILE) ??
             join(getComposerHome(), "mcp-project-approvals.json"));
     },
+    /** Per-workspace MCP invocation trust decisions */
+    get MCP_WORKSPACE_TRUST_FILE() {
+        return (resolveEnvPath(process.env.MAESTRO_MCP_WORKSPACE_TRUST_FILE) ??
+            join(getComposerHome(), "mcp-workspace-trust.json"));
+    },
     /** Project onboarding state */
     get PROJECT_ONBOARDING_FILE() {
         return (resolveEnvPath(process.env.MAESTRO_PROJECT_ONBOARDING_FILE) ??
@@ -141,7 +146,11 @@ export const PATHS = {
     AGENT_CONTEXT_FILES: [
         "AGENTS.override.md",
         "AGENTS.md",
+        "Agents.md",
+        "agents.md",
         "AGENT.md",
+        "Agent.md",
+        "agent.md",
         "CLAUDE.md",
     ],
 };

package/dist/config/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Centralized configuration constants for Composer CLI.\n *\n * This module consolidates magic numbers, default values, and paths\n * to improve maintainability and allow environment-based overrides.\n */\n\nimport { join, resolve } from \"node:path\";\nimport { getHomeDir, resolveEnvPath } from \"../utils/path-expansion.js\";\n\nexport const getComposerHome = (): string =>\n\tresolveEnvPath(process.env.MAESTRO_HOME) ?? join(getHomeDir(), \".maestro\");\n\nexport const getAgentDir = (): string => {\n\tconst envAgentDir =\n\t\tresolveEnvPath(process.env.MAESTRO_AGENT_DIR) ??\n\t\tresolveEnvPath(process.env.PLAYWRIGHT_AGENT_DIR) ??\n\t\tresolveEnvPath(process.env.CODING_AGENT_DIR);\n\treturn envAgentDir || join(getComposerHome(), \"agent\");\n};\n\n/** Parse an int env var, returning `fallback` only when the value is NaN. */\nfunction intEnv(raw: string | undefined, fallback: number): number {\n\tif (raw === undefined) return fallback;\n\tconst n = Number.parseInt(raw, 10);\n\treturn Number.isNaN(n) ? fallback : n;\n}\n\n/**\n * Session management configuration\n */\nexport const SESSION_CONFIG = {\n\t/** Number of entries to buffer before flushing to disk */\n\tWRITE_BATCH_SIZE: Number.parseInt(\n\t\tprocess.env.MAESTRO_SESSION_BATCH_SIZE ?? \"25\",\n\t\t10,\n\t),\n\t/** Default session directory path */\n\tget DEFAULT_DIR(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_SESSION_DIR) ??\n\t\t\tjoin(getAgentDir(), \"sessions\")\n\t\t);\n\t},\n\t/** Maximum number of sessions to retain per working directory (0 = unlimited) */\n\tMAX_SESSIONS: Math.max(0, intEnv(process.env.MAESTRO_MAX_SESSIONS, 100)),\n\t/** Maximum age for sessions in days (0 = unlimited) */\n\tMAX_SESSION_AGE_DAYS: Math.max(\n\t\t0,\n\t\tintEnv(process.env.MAESTRO_MAX_SESSION_AGE_DAYS, 90),\n\t),\n} as const;\n\n/**\n * Tool execution configuration\n */\nexport const TOOL_CONFIG = {\n\t/** Default timeout for bash commands (in milliseconds) */\n\tBASH_DEFAULT_TIMEOUT_MS: Number.parseInt(\n\t\tprocess.env.MAESTRO_BASH_TIMEOUT_MS ?? \"90000\",\n\t\t10,\n\t),\n\t/** Default file read limit (lines) */\n\tREAD_DEFAULT_LIMIT: 2400,\n\t/** Maximum context lines for search results */\n\tSEARCH_MAX_CONTEXT_LINES: 5,\n} as const;\n\n/**\n * Storage paths configuration\n */\nexport const PATHS = {\n\t/** Composer home directory */\n\tget MAESTRO_HOME(): string {\n\t\treturn getComposerHome();\n\t},\n\t/** Todo store file path */\n\tget TODO_STORE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TODO_FILE) ??\n\t\t\tjoin(getComposerHome(), \"todos.json\")\n\t\t);\n\t},\n\t/** Usage tracking file path */\n\tget USAGE_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_USAGE_FILE) ??\n\t\t\tjoin(getComposerHome(), \"usage.json\")\n\t\t);\n\t},\n\t/** Telemetry log file path */\n\tget TELEMETRY_LOG(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TELEMETRY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"telemetry.log\")\n\t\t);\n\t},\n\t/** Tool failure log file path */\n\tget TOOL_FAILURE_LOG(): string {\n\t\treturn join(getComposerHome(), \"tool-failures.log\");\n\t},\n\t/** Project MCP approval decisions */\n\tget MCP_PROJECT_APPROVALS_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_MCP_PROJECT_APPROVALS_FILE) ??\n\t\t\tjoin(getComposerHome(), \"mcp-project-approvals.json\")\n\t\t);\n\t},\n\t/** Project onboarding state */\n\tget PROJECT_ONBOARDING_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_PROJECT_ONBOARDING_FILE) ??\n\t\t\tjoin(getComposerHome(), \"project-onboarding.json\")\n\t\t);\n\t},\n\t/** TUI keybinding overrides */\n\tget TUI_KEYBINDINGS_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_KEYBINDINGS_FILE) ??\n\t\t\tjoin(getComposerHome(), \"keybindings.json\")\n\t\t);\n\t},\n\t/** Background task log directory */\n\tget BACKGROUND_TASK_LOG_DIR(): string {\n\t\treturn join(getComposerHome(), \"background-tasks\");\n\t},\n\t/** UI state file path */\n\tget UI_STATE_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_UI_STATE) ??\n\t\t\tresolve(getAgentDir(), \"ui-state.json\")\n\t\t);\n\t},\n\t/** Command prefs file path */\n\tget COMMAND_PREFS_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_COMMAND_PREFS) ??\n\t\t\tresolve(getAgentDir(), \"command-prefs.json\")\n\t\t);\n\t},\n\t/** TUI tip history file path */\n\tget TUI_TIP_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TUI_TIP_HISTORY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"tips-history.json\")\n\t\t);\n\t},\n\t/** Bash history file path */\n\tget BASH_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_BASH_HISTORY) ??\n\t\t\tjoin(getComposerHome(), \"bash-history.json\")\n\t\t);\n\t},\n\t/** Prompt history file path */\n\tget PROMPT_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_PROMPT_HISTORY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"history\", \"prompts.jsonl\")\n\t\t);\n\t},\n\t/** Tool history file path */\n\tget TOOL_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TOOL_HISTORY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"history\", \"tools.jsonl\")\n\t\t);\n\t},\n\t/** Tools install directory */\n\tget TOOLS_DIR(): string {\n\t\treturn join(getComposerHome(), \"tools\");\n\t},\n\t/** Package cache directory */\n\tget PACKAGE_CACHE_DIR(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_PACKAGE_CACHE_DIR) ??\n\t\t\tjoin(getComposerHome(), \"packages\")\n\t\t);\n\t},\n\t/** Cost tracking database path */\n\tget COST_DB(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_COST_DB) ??\n\t\t\tjoin(getComposerHome(), \"costs.db\")\n\t\t);\n\t},\n\t/** Agent context files */\n\tAGENT_CONTEXT_FILES: [\n\t\t\"AGENTS.override.md\",\n\t\t\"AGENTS.md\",\n\t\t\"AGENT.md\",\n\t\t\"CLAUDE.md\",\n\t] as const,\n} as const;\n\n/**\n * API and network configuration\n */\nexport const API_CONFIG = {\n\t/** Request timeout for LLM API calls (in milliseconds) */\n\tREQUEST_TIMEOUT_MS: Number.parseInt(\n\t\tprocess.env.MAESTRO_API_TIMEOUT_MS ?? \"120000\",\n\t\t10,\n\t),\n\t/** Telemetry sampling rate (0-1) */\n\tTELEMETRY_SAMPLE_RATE: Number.parseFloat(\n\t\tprocess.env.MAESTRO_TELEMETRY_SAMPLE ?? \"1.0\",\n\t),\n} as const;\n\n/**\n * Performance and limits configuration\n */\nexport const LIMITS = {\n\t/** Maximum file size to read (in bytes) */\n\tMAX_FILE_SIZE_BYTES: Number.parseInt(\n\t\tprocess.env.MAESTRO_MAX_FILE_SIZE ?? \"10485760\", // 10MB\n\t\t10,\n\t),\n\t/** Maximum number of search results */\n\tMAX_SEARCH_RESULTS: Number.parseInt(\n\t\tprocess.env.MAESTRO_MAX_SEARCH_RESULTS ?? \"1000\",\n\t\t10,\n\t),\n\t/** Maximum command output length (characters) */\n\tMAX_COMMAND_OUTPUT: 40_000,\n\t/** Test timeout (milliseconds) */\n\tTEST_TIMEOUT_MS: 30_000,\n} as const;\n\n/**\n * Feature flags and mode toggles\n */\nexport const FEATURES = {\n\t/** Enable safe mode (requires plan before mutations) */\n\tSAFE_MODE: process.env.MAESTRO_SAFE_MODE === \"1\",\n\t/** Enable plan mode (ask before mutations via approval) */\n\tPLAN_MODE: process.env.MAESTRO_PLAN_MODE === \"1\",\n\t/** Enable telemetry */\n\tTELEMETRY_ENABLED: process.env.MAESTRO_TELEMETRY === \"true\",\n\t/** Telemetry endpoint URL */\n\tTELEMETRY_ENDPOINT: process.env.MAESTRO_TELEMETRY_ENDPOINT,\n\t/** Enable LSP integration */\n\tLSP_ENABLED: process.env.MAESTRO_LSP_ENABLED !== \"0\",\n\t/** Auto-start LSP servers when enabled */\n\tLSP_AUTOSTART: process.env.MAESTRO_LSP_AUTOSTART === \"1\",\n} as const;\n\n/**\n * Validation helpers\n */\nexport const VALIDATION = {\n\t/** File extensions considered safe for reading */\n\tSAFE_FILE_EXTENSIONS: new Set([\n\t\t\".ts\",\n\t\t\".js\",\n\t\t\".tsx\",\n\t\t\".jsx\",\n\t\t\".json\",\n\t\t\".md\",\n\t\t\".txt\",\n\t\t\".yml\",\n\t\t\".yaml\",\n\t\t\".toml\",\n\t\t\".xml\",\n\t\t\".html\",\n\t\t\".css\",\n\t\t\".py\",\n\t\t\".go\",\n\t\t\".rs\",\n\t\t\".java\",\n\t\t\".c\",\n\t\t\".cpp\",\n\t\t\".h\",\n\t]),\n} as const;\n\n/**\n * Error messages\n */\nexport const ERRORS = {\n\tSESSION_WRITE_FAILED: \"Failed to write session data\",\n\tSESSION_READ_FAILED: \"Failed to read session file\",\n\tTOOL_TIMEOUT: \"Tool execution timed out\",\n\tINVALID_PATH: \"Invalid or unsafe file path\",\n\tFILE_TOO_LARGE: \"File size exceeds maximum allowed limit\",\n\tTOOL_NOT_FOUND: \"Requested tool not found\",\n} as const;\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Centralized configuration constants for Composer CLI.\n *\n * This module consolidates magic numbers, default values, and paths\n * to improve maintainability and allow environment-based overrides.\n */\n\nimport { join, resolve } from \"node:path\";\nimport { getHomeDir, resolveEnvPath } from \"../utils/path-expansion.js\";\n\nexport const getComposerHome = (): string =>\n\tresolveEnvPath(process.env.MAESTRO_HOME) ?? join(getHomeDir(), \".maestro\");\n\nexport const getAgentDir = (): string => {\n\tconst envAgentDir =\n\t\tresolveEnvPath(process.env.MAESTRO_AGENT_DIR) ??\n\t\tresolveEnvPath(process.env.PLAYWRIGHT_AGENT_DIR) ??\n\t\tresolveEnvPath(process.env.CODING_AGENT_DIR);\n\treturn envAgentDir || join(getComposerHome(), \"agent\");\n};\n\n/** Parse an int env var, returning `fallback` only when the value is NaN. */\nfunction intEnv(raw: string | undefined, fallback: number): number {\n\tif (raw === undefined) return fallback;\n\tconst n = Number.parseInt(raw, 10);\n\treturn Number.isNaN(n) ? fallback : n;\n}\n\n/**\n * Session management configuration\n */\nexport const SESSION_CONFIG = {\n\t/** Number of entries to buffer before flushing to disk */\n\tWRITE_BATCH_SIZE: Number.parseInt(\n\t\tprocess.env.MAESTRO_SESSION_BATCH_SIZE ?? \"25\",\n\t\t10,\n\t),\n\t/** Default session directory path */\n\tget DEFAULT_DIR(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_SESSION_DIR) ??\n\t\t\tjoin(getAgentDir(), \"sessions\")\n\t\t);\n\t},\n\t/** Maximum number of sessions to retain per working directory (0 = unlimited) */\n\tMAX_SESSIONS: Math.max(0, intEnv(process.env.MAESTRO_MAX_SESSIONS, 100)),\n\t/** Maximum age for sessions in days (0 = unlimited) */\n\tMAX_SESSION_AGE_DAYS: Math.max(\n\t\t0,\n\t\tintEnv(process.env.MAESTRO_MAX_SESSION_AGE_DAYS, 90),\n\t),\n} as const;\n\n/**\n * Tool execution configuration\n */\nexport const TOOL_CONFIG = {\n\t/** Default timeout for bash commands (in milliseconds) */\n\tBASH_DEFAULT_TIMEOUT_MS: Number.parseInt(\n\t\tprocess.env.MAESTRO_BASH_TIMEOUT_MS ?? \"90000\",\n\t\t10,\n\t),\n\t/** Default file read limit (lines) */\n\tREAD_DEFAULT_LIMIT: 2400,\n\t/** Maximum context lines for search results */\n\tSEARCH_MAX_CONTEXT_LINES: 5,\n} as const;\n\n/**\n * Storage paths configuration\n */\nexport const PATHS = {\n\t/** Composer home directory */\n\tget MAESTRO_HOME(): string {\n\t\treturn getComposerHome();\n\t},\n\t/** Todo store file path */\n\tget TODO_STORE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TODO_FILE) ??\n\t\t\tjoin(getComposerHome(), \"todos.json\")\n\t\t);\n\t},\n\t/** Usage tracking file path */\n\tget USAGE_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_USAGE_FILE) ??\n\t\t\tjoin(getComposerHome(), \"usage.json\")\n\t\t);\n\t},\n\t/** Telemetry log file path */\n\tget TELEMETRY_LOG(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TELEMETRY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"telemetry.log\")\n\t\t);\n\t},\n\t/** Tool failure log file path */\n\tget TOOL_FAILURE_LOG(): string {\n\t\treturn join(getComposerHome(), \"tool-failures.log\");\n\t},\n\t/** Project MCP approval decisions */\n\tget MCP_PROJECT_APPROVALS_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_MCP_PROJECT_APPROVALS_FILE) ??\n\t\t\tjoin(getComposerHome(), \"mcp-project-approvals.json\")\n\t\t);\n\t},\n\t/** Per-workspace MCP invocation trust decisions */\n\tget MCP_WORKSPACE_TRUST_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_MCP_WORKSPACE_TRUST_FILE) ??\n\t\t\tjoin(getComposerHome(), \"mcp-workspace-trust.json\")\n\t\t);\n\t},\n\t/** Project onboarding state */\n\tget PROJECT_ONBOARDING_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_PROJECT_ONBOARDING_FILE) ??\n\t\t\tjoin(getComposerHome(), \"project-onboarding.json\")\n\t\t);\n\t},\n\t/** TUI keybinding overrides */\n\tget TUI_KEYBINDINGS_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_KEYBINDINGS_FILE) ??\n\t\t\tjoin(getComposerHome(), \"keybindings.json\")\n\t\t);\n\t},\n\t/** Background task log directory */\n\tget BACKGROUND_TASK_LOG_DIR(): string {\n\t\treturn join(getComposerHome(), \"background-tasks\");\n\t},\n\t/** UI state file path */\n\tget UI_STATE_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_UI_STATE) ??\n\t\t\tresolve(getAgentDir(), \"ui-state.json\")\n\t\t);\n\t},\n\t/** Command prefs file path */\n\tget COMMAND_PREFS_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_COMMAND_PREFS) ??\n\t\t\tresolve(getAgentDir(), \"command-prefs.json\")\n\t\t);\n\t},\n\t/** TUI tip history file path */\n\tget TUI_TIP_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TUI_TIP_HISTORY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"tips-history.json\")\n\t\t);\n\t},\n\t/** Bash history file path */\n\tget BASH_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_BASH_HISTORY) ??\n\t\t\tjoin(getComposerHome(), \"bash-history.json\")\n\t\t);\n\t},\n\t/** Prompt history file path */\n\tget PROMPT_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_PROMPT_HISTORY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"history\", \"prompts.jsonl\")\n\t\t);\n\t},\n\t/** Tool history file path */\n\tget TOOL_HISTORY_FILE(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_TOOL_HISTORY_FILE) ??\n\t\t\tjoin(getComposerHome(), \"history\", \"tools.jsonl\")\n\t\t);\n\t},\n\t/** Tools install directory */\n\tget TOOLS_DIR(): string {\n\t\treturn join(getComposerHome(), \"tools\");\n\t},\n\t/** Package cache directory */\n\tget PACKAGE_CACHE_DIR(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_PACKAGE_CACHE_DIR) ??\n\t\t\tjoin(getComposerHome(), \"packages\")\n\t\t);\n\t},\n\t/** Cost tracking database path */\n\tget COST_DB(): string {\n\t\treturn (\n\t\t\tresolveEnvPath(process.env.MAESTRO_COST_DB) ??\n\t\t\tjoin(getComposerHome(), \"costs.db\")\n\t\t);\n\t},\n\t/** Agent context files */\n\tAGENT_CONTEXT_FILES: [\n\t\t\"AGENTS.override.md\",\n\t\t\"AGENTS.md\",\n\t\t\"Agents.md\",\n\t\t\"agents.md\",\n\t\t\"AGENT.md\",\n\t\t\"Agent.md\",\n\t\t\"agent.md\",\n\t\t\"CLAUDE.md\",\n\t] as const,\n} as const;\n\n/**\n * API and network configuration\n */\nexport const API_CONFIG = {\n\t/** Request timeout for LLM API calls (in milliseconds) */\n\tREQUEST_TIMEOUT_MS: Number.parseInt(\n\t\tprocess.env.MAESTRO_API_TIMEOUT_MS ?? \"120000\",\n\t\t10,\n\t),\n\t/** Telemetry sampling rate (0-1) */\n\tTELEMETRY_SAMPLE_RATE: Number.parseFloat(\n\t\tprocess.env.MAESTRO_TELEMETRY_SAMPLE ?? \"1.0\",\n\t),\n} as const;\n\n/**\n * Performance and limits configuration\n */\nexport const LIMITS = {\n\t/** Maximum file size to read (in bytes) */\n\tMAX_FILE_SIZE_BYTES: Number.parseInt(\n\t\tprocess.env.MAESTRO_MAX_FILE_SIZE ?? \"10485760\", // 10MB\n\t\t10,\n\t),\n\t/** Maximum number of search results */\n\tMAX_SEARCH_RESULTS: Number.parseInt(\n\t\tprocess.env.MAESTRO_MAX_SEARCH_RESULTS ?? \"1000\",\n\t\t10,\n\t),\n\t/** Maximum command output length (characters) */\n\tMAX_COMMAND_OUTPUT: 40_000,\n\t/** Test timeout (milliseconds) */\n\tTEST_TIMEOUT_MS: 30_000,\n} as const;\n\n/**\n * Feature flags and mode toggles\n */\nexport const FEATURES = {\n\t/** Enable safe mode (requires plan before mutations) */\n\tSAFE_MODE: process.env.MAESTRO_SAFE_MODE === \"1\",\n\t/** Enable plan mode (ask before mutations via approval) */\n\tPLAN_MODE: process.env.MAESTRO_PLAN_MODE === \"1\",\n\t/** Enable telemetry */\n\tTELEMETRY_ENABLED: process.env.MAESTRO_TELEMETRY === \"true\",\n\t/** Telemetry endpoint URL */\n\tTELEMETRY_ENDPOINT: process.env.MAESTRO_TELEMETRY_ENDPOINT,\n\t/** Enable LSP integration */\n\tLSP_ENABLED: process.env.MAESTRO_LSP_ENABLED !== \"0\",\n\t/** Auto-start LSP servers when enabled */\n\tLSP_AUTOSTART: process.env.MAESTRO_LSP_AUTOSTART === \"1\",\n} as const;\n\n/**\n * Validation helpers\n */\nexport const VALIDATION = {\n\t/** File extensions considered safe for reading */\n\tSAFE_FILE_EXTENSIONS: new Set([\n\t\t\".ts\",\n\t\t\".js\",\n\t\t\".tsx\",\n\t\t\".jsx\",\n\t\t\".json\",\n\t\t\".md\",\n\t\t\".txt\",\n\t\t\".yml\",\n\t\t\".yaml\",\n\t\t\".toml\",\n\t\t\".xml\",\n\t\t\".html\",\n\t\t\".css\",\n\t\t\".py\",\n\t\t\".go\",\n\t\t\".rs\",\n\t\t\".java\",\n\t\t\".c\",\n\t\t\".cpp\",\n\t\t\".h\",\n\t]),\n} as const;\n\n/**\n * Error messages\n */\nexport const ERRORS = {\n\tSESSION_WRITE_FAILED: \"Failed to write session data\",\n\tSESSION_READ_FAILED: \"Failed to read session file\",\n\tTOOL_TIMEOUT: \"Tool execution timed out\",\n\tINVALID_PATH: \"Invalid or unsafe file path\",\n\tFILE_TOO_LARGE: \"File size exceeds maximum allowed limit\",\n\tTOOL_NOT_FOUND: \"Requested tool not found\",\n} as const;\n"]}

package/dist/config/feature-flags.d.ts

@@ -1,7 +1,12 @@
+type FeatureFlagEnv = {
+    EVALOPS_FEATURE_FLAGS_PATH?: string | undefined;
+};
 export declare const MAESTRO_EVALOPS_MANAGED_KILL_SWITCH = "platform.kill_switches.maestro.evalops_managed";
 export declare const MAESTRO_AUTONOMOUS_ACTIONS_KILL_SWITCH = "platform.kill_switches.maestro.autonomous_actions";
 export declare const MAESTRO_PLATFORM_RUNTIME_BRIDGE_KILL_SWITCH = "platform.kill_switches.maestro.platform_runtime_bridge";
+export declare const MAESTRO_PLATFORM_EVENTS_KILL_SWITCH = "platform.kill_switches.maestro.platform_events";
 export declare const MAESTRO_DRAFT_AND_CONFIRM_DEFAULT_FLAG = "maestro.agent_authority.draft_and_confirm_default";
+export declare const MAESTRO_PLATFORM_EVENTS_PUBLISHER_FLAG = "maestro.platform_events.publisher_enabled";
 export declare const MAESTRO_PLATFORM_RUNTIME_AGENT_RUNTIME_OBSERVE_FLAG = "maestro.platform_runtime.agent_runtime_observe";
 export declare const MAESTRO_PLATFORM_RUNTIME_TOOL_EXECUTION_BRIDGE_FLAG = "maestro.platform_runtime.tool_execution_bridge";
 export type FeatureFlagDecision = {
@@ -37,10 +42,13 @@ export type FeatureFlagRemoteOptions = {
     headers?: Record<string, string>;
     timeoutMs?: number;
 };
-export declare function isFeatureFlagEnabled(key: string): boolean;
+export declare function isFeatureFlagSnapshotConfigured(env?: FeatureFlagEnv): boolean;
+export declare function isFeatureFlagEnabled(key: string, env?: FeatureFlagEnv): boolean;
 export declare function areAutonomousActionsDisabled(): boolean;
 export declare function isDraftAndConfirmDefaultEnabled(): boolean;
 export declare function isPlatformRuntimeBridgeDisabled(): boolean;
+export declare function areMaestroPlatformEventsDisabled(env?: FeatureFlagEnv): boolean;
+export declare function isMaestroPlatformEventsPublisherEnabled(env?: FeatureFlagEnv): boolean;
 export declare function isPlatformRuntimeObserveEnabled(): boolean;
 export declare function isPlatformToolExecutionBridgeEnabled(): boolean;
 export declare function evaluateFeatureFlag(key: string, context: FeatureFlagRequestContext, defaultValue?: boolean, options?: FeatureFlagRemoteOptions): Promise<FeatureFlagDecision>;
@@ -49,4 +57,5 @@ export declare function assignExperiment(experimentId: string, context: FeatureF
     recordExposure?: boolean;
 }): Promise<ExperimentAssignment>;
 export declare function resetFeatureFlagCacheForTests(): void;
+export {};
 //# sourceMappingURL=feature-flags.d.ts.map

package/dist/config/feature-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../src/config/feature-flags.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,mCAAmC,mDACC,CAAC;AAClD,eAAO,MAAM,sCAAsC,sDACC,CAAC;AACrD,eAAO,MAAM,2CAA2C,2DACC,CAAC;AAC1D,eAAO,MAAM,sCAAsC,sDACC,CAAC;AACrD,eAAO,MAAM,mDAAmD,mDACf,CAAC;AAClD,eAAO,MAAM,mDAAmD,mDACf,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC1E,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA0EF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAczD;AAED,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAIzD;AAED,wBAAgB,oCAAoC,IAAI,OAAO,CAI9D;AAED,wBAAsB,mBAAmB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,yBAAyB,EAClC,YAAY,UAAQ,EACpB,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAkE9B;AAED,wBAAsB,gBAAgB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE,wBAAwB,GAAG;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;CACpB,GACJ,OAAO,CAAC,oBAAoB,CAAC,CAqE/B;AAuID,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD"}
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../src/config/feature-flags.ts"],"names":[],"mappings":"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"}

package/dist/config/feature-flags.js

@@ -5,14 +5,16 @@ const featureFlagCache = {
 export const MAESTRO_EVALOPS_MANAGED_KILL_SWITCH = "platform.kill_switches.maestro.evalops_managed";
 export const MAESTRO_AUTONOMOUS_ACTIONS_KILL_SWITCH = "platform.kill_switches.maestro.autonomous_actions";
 export const MAESTRO_PLATFORM_RUNTIME_BRIDGE_KILL_SWITCH = "platform.kill_switches.maestro.platform_runtime_bridge";
+export const MAESTRO_PLATFORM_EVENTS_KILL_SWITCH = "platform.kill_switches.maestro.platform_events";
 export const MAESTRO_DRAFT_AND_CONFIRM_DEFAULT_FLAG = "maestro.agent_authority.draft_and_confirm_default";
+export const MAESTRO_PLATFORM_EVENTS_PUBLISHER_FLAG = "maestro.platform_events.publisher_enabled";
 export const MAESTRO_PLATFORM_RUNTIME_AGENT_RUNTIME_OBSERVE_FLAG = "maestro.platform_runtime.agent_runtime_observe";
 export const MAESTRO_PLATFORM_RUNTIME_TOOL_EXECUTION_BRIDGE_FLAG = "maestro.platform_runtime.tool_execution_bridge";
 const DEFAULT_IN_CLUSTER_FLAG_CONTROL_URL = "http://flag-control-service.evalops.svc.cluster.local:8080";
 const DEFAULT_OUT_OF_CLUSTER_FLAG_CONTROL_URL = "https://flags.internal.evalops.dev";
 const DEFAULT_REMOTE_TIMEOUT_MS = 2_000;
-function getFeatureFlagsPath() {
-    const configured = process.env.EVALOPS_FEATURE_FLAGS_PATH?.trim();
+function getFeatureFlagsPath(env = process.env) {
+    const configured = env.EVALOPS_FEATURE_FLAGS_PATH?.trim();
     return configured ? configured : undefined;
 }
 function getFeatureFlagRemoteBaseUrl() {
@@ -32,8 +34,8 @@ function getFeatureFlagRemoteHeaders(headers) {
     }
     return merged;
 }
-function readFeatureFlagSnapshot() {
-    const path = getFeatureFlagsPath();
+function readFeatureFlagSnapshot(env = process.env) {
+    const path = getFeatureFlagsPath(env);
     if (!path) {
         featureFlagCache.lastKnownSnapshot = null;
         featureFlagCache.lastPath = undefined;
@@ -61,12 +63,15 @@ function readFeatureFlagSnapshot() {
         return featureFlagCache.lastKnownSnapshot;
     }
 }
-export function isFeatureFlagEnabled(key) {
+export function isFeatureFlagSnapshotConfigured(env = process.env) {
+    return getFeatureFlagsPath(env) !== undefined;
+}
+export function isFeatureFlagEnabled(key, env = process.env) {
     const normalizedKey = key.trim();
     if (!normalizedKey) {
         return false;
     }
-    const snapshot = readFeatureFlagSnapshot();
+    const snapshot = readFeatureFlagSnapshot(env);
     if (!snapshot?.flags?.length) {
         return false;
     }
@@ -81,6 +86,12 @@ export function isDraftAndConfirmDefaultEnabled() {
 export function isPlatformRuntimeBridgeDisabled() {
     return isFeatureFlagEnabled(MAESTRO_PLATFORM_RUNTIME_BRIDGE_KILL_SWITCH);
 }
+export function areMaestroPlatformEventsDisabled(env = process.env) {
+    return isFeatureFlagEnabled(MAESTRO_PLATFORM_EVENTS_KILL_SWITCH, env);
+}
+export function isMaestroPlatformEventsPublisherEnabled(env = process.env) {
+    return isFeatureFlagEnabled(MAESTRO_PLATFORM_EVENTS_PUBLISHER_FLAG, env);
+}
 export function isPlatformRuntimeObserveEnabled() {
     return isFeatureFlagEnabled(MAESTRO_PLATFORM_RUNTIME_AGENT_RUNTIME_OBSERVE_FLAG);
 }

package/dist/config/feature-flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature-flags.js","sourceRoot":"","sources":["../../src/config/feature-flags.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync, statSync } from \"node:fs\";\n\ntype FeatureFlag = {\n\tenabled?: boolean;\n\tkey?: string;\n};\n\ntype FeatureFlagSnapshot = {\n\tflags?: FeatureFlag[];\n\tschema_version?: number;\n};\n\ntype FeatureFlagCache = {\n\tlastKnownSnapshot: FeatureFlagSnapshot | null;\n\tlastPath?: string;\n\tlastStatMtimeMs?: number;\n};\n\nconst featureFlagCache: FeatureFlagCache = {\n\tlastKnownSnapshot: null,\n};\n\nexport const MAESTRO_EVALOPS_MANAGED_KILL_SWITCH =\n\t\"platform.kill_switches.maestro.evalops_managed\";\nexport const MAESTRO_AUTONOMOUS_ACTIONS_KILL_SWITCH =\n\t\"platform.kill_switches.maestro.autonomous_actions\";\nexport const MAESTRO_PLATFORM_RUNTIME_BRIDGE_KILL_SWITCH =\n\t\"platform.kill_switches.maestro.platform_runtime_bridge\";\nexport const MAESTRO_DRAFT_AND_CONFIRM_DEFAULT_FLAG =\n\t\"maestro.agent_authority.draft_and_confirm_default\";\nexport const MAESTRO_PLATFORM_RUNTIME_AGENT_RUNTIME_OBSERVE_FLAG =\n\t\"maestro.platform_runtime.agent_runtime_observe\";\nexport const MAESTRO_PLATFORM_RUNTIME_TOOL_EXECUTION_BRIDGE_FLAG =\n\t\"maestro.platform_runtime.tool_execution_bridge\";\n\nexport type FeatureFlagDecision = {\n\tkey: string;\n\tmetadata: Record<string, unknown>;\n\treason: string;\n\tvalue: boolean;\n\tvariant: string;\n};\n\nexport type ExperimentAssignment = {\n\tassigned: boolean;\n\tbucket: number;\n\texperimentId: string;\n\texposureRecorded: boolean;\n\tflagKey: string;\n\tholdoutId?: string;\n\tinHoldout: boolean;\n\tlayerId?: string;\n\tmetadata: Record<string, unknown>;\n\tnamespaceEnd: number;\n\tnamespaceStart: number;\n\treason: string;\n\tsubject: string;\n\tvariant: string;\n\tvariantBucket: number;\n};\n\nexport type FeatureFlagRequestContext = {\n\tattributes?: Record<string, string | number | boolean | null | undefined>;\n\tsubject: string;\n};\n\nexport type FeatureFlagRemoteOptions = {\n\tbaseUrl?: string;\n\theaders?: Record<string, string>;\n\ttimeoutMs?: number;\n};\n\nconst DEFAULT_IN_CLUSTER_FLAG_CONTROL_URL =\n\t\"http://flag-control-service.evalops.svc.cluster.local:8080\";\nconst DEFAULT_OUT_OF_CLUSTER_FLAG_CONTROL_URL =\n\t\"https://flags.internal.evalops.dev\";\nconst DEFAULT_REMOTE_TIMEOUT_MS = 2_000;\n\nfunction getFeatureFlagsPath(): string | undefined {\n\tconst configured = process.env.EVALOPS_FEATURE_FLAGS_PATH?.trim();\n\treturn configured ? configured : undefined;\n}\n\nfunction getFeatureFlagRemoteBaseUrl(): string {\n\treturn (\n\t\tprocess.env.EVALOPS_FEATURE_FLAGS_URL?.trim() ||\n\t\tprocess.env.EVALOPS_FLAG_CONTROL_URL?.trim() ||\n\t\t(process.env.KUBERNETES_SERVICE_HOST\n\t\t\t? DEFAULT_IN_CLUSTER_FLAG_CONTROL_URL\n\t\t\t: DEFAULT_OUT_OF_CLUSTER_FLAG_CONTROL_URL)\n\t).replace(/\\/+$/, \"\");\n}\n\nfunction getFeatureFlagRemoteHeaders(\n\theaders?: Record<string, string>,\n): Record<string, string> {\n\tconst merged: Record<string, string> = { ...(headers ?? {}) };\n\tconst token =\n\t\tprocess.env.EVALOPS_FEATURE_FLAGS_BEARER_TOKEN?.trim() ||\n\t\tprocess.env.EVALOPS_FLAG_CONTROL_BEARER_TOKEN?.trim();\n\tconst hasAuthorization = Object.keys(merged).some(\n\t\t(key) => key.toLowerCase() === \"authorization\",\n\t);\n\tif (token && !hasAuthorization) {\n\t\tmerged.Authorization = `Bearer ${token}`;\n\t}\n\treturn merged;\n}\n\nfunction readFeatureFlagSnapshot(): FeatureFlagSnapshot | null {\n\tconst path = getFeatureFlagsPath();\n\tif (!path) {\n\t\tfeatureFlagCache.lastKnownSnapshot = null;\n\t\tfeatureFlagCache.lastPath = undefined;\n\t\tfeatureFlagCache.lastStatMtimeMs = undefined;\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tconst stats = statSync(path);\n\t\tif (\n\t\t\tfeatureFlagCache.lastPath === path &&\n\t\t\tfeatureFlagCache.lastStatMtimeMs === stats.mtimeMs\n\t\t) {\n\t\t\treturn featureFlagCache.lastKnownSnapshot;\n\t\t}\n\n\t\tconst snapshot = JSON.parse(\n\t\t\treadFileSync(path, \"utf8\"),\n\t\t) as FeatureFlagSnapshot;\n\t\tfeatureFlagCache.lastKnownSnapshot = snapshot;\n\t\tfeatureFlagCache.lastPath = path;\n\t\tfeatureFlagCache.lastStatMtimeMs = stats.mtimeMs;\n\t\treturn snapshot;\n\t} catch {\n\t\tif (featureFlagCache.lastPath !== path) {\n\t\t\tfeatureFlagCache.lastKnownSnapshot = null;\n\t\t}\n\t\tfeatureFlagCache.lastPath = path;\n\t\tfeatureFlagCache.lastStatMtimeMs = undefined;\n\t\treturn featureFlagCache.lastKnownSnapshot;\n\t}\n}\n\nexport function isFeatureFlagEnabled(key: string): boolean {\n\tconst normalizedKey = key.trim();\n\tif (!normalizedKey) {\n\t\treturn false;\n\t}\n\n\tconst snapshot = readFeatureFlagSnapshot();\n\tif (!snapshot?.flags?.length) {\n\t\treturn false;\n\t}\n\n\treturn snapshot.flags.some(\n\t\t(flag) => flag?.key?.trim() === normalizedKey && flag.enabled === true,\n\t);\n}\n\nexport function areAutonomousActionsDisabled(): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_AUTONOMOUS_ACTIONS_KILL_SWITCH);\n}\n\nexport function isDraftAndConfirmDefaultEnabled(): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_DRAFT_AND_CONFIRM_DEFAULT_FLAG);\n}\n\nexport function isPlatformRuntimeBridgeDisabled(): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_PLATFORM_RUNTIME_BRIDGE_KILL_SWITCH);\n}\n\nexport function isPlatformRuntimeObserveEnabled(): boolean {\n\treturn isFeatureFlagEnabled(\n\t\tMAESTRO_PLATFORM_RUNTIME_AGENT_RUNTIME_OBSERVE_FLAG,\n\t);\n}\n\nexport function isPlatformToolExecutionBridgeEnabled(): boolean {\n\treturn isFeatureFlagEnabled(\n\t\tMAESTRO_PLATFORM_RUNTIME_TOOL_EXECUTION_BRIDGE_FLAG,\n\t);\n}\n\nexport async function evaluateFeatureFlag(\n\tkey: string,\n\tcontext: FeatureFlagRequestContext,\n\tdefaultValue = false,\n\toptions: FeatureFlagRemoteOptions = {},\n): Promise<FeatureFlagDecision> {\n\tconst normalizedKey = key.trim();\n\tif (!normalizedKey) {\n\t\treturn fallbackDecision(\n\t\t\tnormalizedKey,\n\t\t\tcontext,\n\t\t\tdefaultValue,\n\t\t\t\"missing_key\",\n\t\t);\n\t}\n\n\ttry {\n\t\tconst response = await postJSON(\n\t\t\t`${remoteBaseUrl(options)}/ofrep/v1/evaluate/flags/${encodeURIComponent(normalizedKey)}`,\n\t\t\tJSON.stringify({ context: remoteContext(context) }),\n\t\t\toptions,\n\t\t);\n\t\tif (response.status === 404) {\n\t\t\treturn fallbackDecision(\n\t\t\t\tnormalizedKey,\n\t\t\t\tcontext,\n\t\t\t\tdefaultValue,\n\t\t\t\t\"not_found\",\n\t\t\t);\n\t\t}\n\t\tif (!response.ok) {\n\t\t\treturn fallbackDecision(\n\t\t\t\tnormalizedKey,\n\t\t\t\tcontext,\n\t\t\t\tdefaultValue,\n\t\t\t\t`remote_status_${response.status}`,\n\t\t\t);\n\t\t}\n\n\t\tconst payload = (await response.json()) as {\n\t\t\tkey?: string;\n\t\t\tmetadata?: Record<string, unknown>;\n\t\t\treason?: string;\n\t\t\tvalue?: unknown;\n\t\t\tvariant?: string;\n\t\t};\n\t\tif (typeof payload.value !== \"boolean\") {\n\t\t\treturn fallbackDecision(\n\t\t\t\tnormalizedKey,\n\t\t\t\tcontext,\n\t\t\t\tdefaultValue,\n\t\t\t\t\"invalid_remote_value\",\n\t\t\t);\n\t\t}\n\t\tconst metadata = getRecord(payload.metadata);\n\t\treturn {\n\t\t\tkey: payload.key?.trim() || normalizedKey,\n\t\t\tmetadata,\n\t\t\treason:\n\t\t\t\tgetString(metadata.flag_reason) || payload.reason?.trim() || \"remote\",\n\t\t\tvalue: payload.value,\n\t\t\tvariant: payload.variant?.trim() || booleanVariant(payload.value),\n\t\t};\n\t} catch (error) {\n\t\treturn fallbackDecision(\n\t\t\tnormalizedKey,\n\t\t\tcontext,\n\t\t\tdefaultValue,\n\t\t\terror instanceof Error ? error.message : \"remote_error\",\n\t\t);\n\t}\n}\n\nexport async function assignExperiment(\n\texperimentId: string,\n\tcontext: FeatureFlagRequestContext,\n\toptions: FeatureFlagRemoteOptions & {\n\t\tmetadata?: Record<string, unknown>;\n\t\trecordExposure?: boolean;\n\t} = {},\n): Promise<ExperimentAssignment> {\n\tconst normalizedExperimentId = experimentId.trim();\n\tif (!normalizedExperimentId) {\n\t\treturn missingAssignment(\n\t\t\tnormalizedExperimentId,\n\t\t\tcontext,\n\t\t\t\"missing_experiment_id\",\n\t\t);\n\t}\n\tconst subject = context.subject.trim();\n\tif (!subject) {\n\t\treturn missingAssignment(\n\t\t\tnormalizedExperimentId,\n\t\t\tcontext,\n\t\t\t\"missing_subject\",\n\t\t);\n\t}\n\n\ttry {\n\t\tconst response = await postJSON(\n\t\t\t`${remoteBaseUrl(options)}/api/experiments/${encodeURIComponent(normalizedExperimentId)}/assign`,\n\t\t\tJSON.stringify({\n\t\t\t\tcontext: remoteContext(context),\n\t\t\t\tmetadata: options.metadata ?? {},\n\t\t\t\trecord_exposure: options.recordExposure,\n\t\t\t\tsubject,\n\t\t\t}),\n\t\t\toptions,\n\t\t);\n\t\tif (response.status === 404) {\n\t\t\treturn missingAssignment(\n\t\t\t\tnormalizedExperimentId,\n\t\t\t\tcontext,\n\t\t\t\t\"missing_experiment\",\n\t\t\t);\n\t\t}\n\t\tif (!response.ok) {\n\t\t\treturn missingAssignment(\n\t\t\t\tnormalizedExperimentId,\n\t\t\t\tcontext,\n\t\t\t\t`remote_status_${response.status}`,\n\t\t\t);\n\t\t}\n\n\t\tconst payload = (await response.json()) as Record<string, unknown>;\n\t\treturn {\n\t\t\tassigned: payload.assigned === true,\n\t\t\tbucket: getNumber(payload.bucket),\n\t\t\texperimentId: getString(payload.experiment_id) || normalizedExperimentId,\n\t\t\texposureRecorded: payload.exposure_recorded === true,\n\t\t\tflagKey: getString(payload.flag_key),\n\t\t\tholdoutId: getString(payload.holdout_id) || undefined,\n\t\t\tinHoldout: payload.in_holdout === true,\n\t\t\tlayerId: getString(payload.layer_id) || undefined,\n\t\t\tmetadata: getRecord(payload.metadata),\n\t\t\tnamespaceEnd: getNumber(payload.namespace_end),\n\t\t\tnamespaceStart: getNumber(payload.namespace_start),\n\t\t\treason: getString(payload.reason) || \"remote\",\n\t\t\tsubject: getString(payload.subject) || subject,\n\t\t\tvariant: getString(payload.variant),\n\t\t\tvariantBucket: getNumber(payload.variant_bucket),\n\t\t};\n\t} catch (error) {\n\t\treturn missingAssignment(\n\t\t\tnormalizedExperimentId,\n\t\t\tcontext,\n\t\t\terror instanceof Error ? error.message : \"remote_error\",\n\t\t);\n\t}\n}\n\nfunction remoteBaseUrl(options: FeatureFlagRemoteOptions): string {\n\tconst configured = options.baseUrl?.trim().replace(/\\/+$/, \"\");\n\treturn configured || getFeatureFlagRemoteBaseUrl();\n}\n\nfunction remoteContext(\n\tcontext: FeatureFlagRequestContext,\n): Record<string, string | number | boolean> {\n\tconst remote: Record<string, string | number | boolean> = {};\n\tfor (const [key, value] of Object.entries(context.attributes ?? {})) {\n\t\tconst normalizedKey = key.trim();\n\t\tif (!normalizedKey || value == null) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (normalizedKey === \"subject\" || normalizedKey === \"targetingKey\") {\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof value === \"string\") {\n\t\t\tconst normalizedValue = value.trim();\n\t\t\tif (normalizedValue) {\n\t\t\t\tremote[normalizedKey] = normalizedValue;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tremote[normalizedKey] = value;\n\t}\n\tconst subject = context.subject.trim();\n\tif (subject) {\n\t\tremote.subject = subject;\n\t\tremote.targetingKey = subject;\n\t}\n\treturn remote;\n}\n\nfunction remoteTimeoutMs(\n\toptions: FeatureFlagRemoteOptions,\n): number | undefined {\n\tif (options.timeoutMs == null) {\n\t\treturn DEFAULT_REMOTE_TIMEOUT_MS;\n\t}\n\tif (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0) {\n\t\treturn undefined;\n\t}\n\treturn Math.max(1, Math.trunc(options.timeoutMs));\n}\n\nasync function postJSON(\n\turl: string,\n\tbody: string,\n\toptions: FeatureFlagRemoteOptions,\n): Promise<Response> {\n\tconst controller = new AbortController();\n\tconst timeoutMs = remoteTimeoutMs(options);\n\tlet timeout: ReturnType<typeof setTimeout> | undefined;\n\tif (timeoutMs != null) {\n\t\ttimeout = setTimeout(() => controller.abort(), timeoutMs);\n\t}\n\ttry {\n\t\treturn await fetch(url, {\n\t\t\tbody,\n\t\t\theaders: {\n\t\t\t\taccept: \"application/json\",\n\t\t\t\t\"content-type\": \"application/json\",\n\t\t\t\t...getFeatureFlagRemoteHeaders(options.headers),\n\t\t\t},\n\t\t\tmethod: \"POST\",\n\t\t\tsignal: controller.signal,\n\t\t});\n\t} finally {\n\t\tif (timeout != null) {\n\t\t\tclearTimeout(timeout);\n\t\t}\n\t}\n}\n\nfunction fallbackDecision(\n\tkey: string,\n\tcontext: FeatureFlagRequestContext,\n\tdefaultValue: boolean,\n\treason: string,\n): FeatureFlagDecision {\n\treturn {\n\t\tkey,\n\t\tmetadata: {\n\t\t\tfallback_used: true,\n\t\t\tflag_subject: context.subject.trim(),\n\t\t},\n\t\treason,\n\t\tvalue: defaultValue,\n\t\tvariant: booleanVariant(defaultValue),\n\t};\n}\n\nfunction missingAssignment(\n\texperimentId: string,\n\tcontext: FeatureFlagRequestContext,\n\treason: string,\n): ExperimentAssignment {\n\treturn {\n\t\tassigned: false,\n\t\tbucket: 0,\n\t\texperimentId,\n\t\texposureRecorded: false,\n\t\tflagKey: \"\",\n\t\tinHoldout: false,\n\t\tmetadata: { fallback_used: true },\n\t\tnamespaceEnd: 0,\n\t\tnamespaceStart: 0,\n\t\treason,\n\t\tsubject: context.subject.trim(),\n\t\tvariant: \"\",\n\t\tvariantBucket: 0,\n\t};\n}\n\nfunction booleanVariant(value: boolean): string {\n\treturn value ? \"true\" : \"false\";\n}\n\nfunction getRecord(value: unknown): Record<string, unknown> {\n\treturn value != null && typeof value === \"object\" && !Array.isArray(value)\n\t\t? (value as Record<string, unknown>)\n\t\t: {};\n}\n\nfunction getString(value: unknown): string {\n\treturn typeof value === \"string\" ? value.trim() : \"\";\n}\n\nfunction getNumber(value: unknown): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : 0;\n}\n\nexport function resetFeatureFlagCacheForTests(): void {\n\tfeatureFlagCache.lastKnownSnapshot = null;\n\tfeatureFlagCache.lastPath = undefined;\n\tfeatureFlagCache.lastStatMtimeMs = undefined;\n}\n"]}
+{"version":3,"file":"feature-flags.js","sourceRoot":"","sources":["../../src/config/feature-flags.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync, statSync } from \"node:fs\";\n\ntype FeatureFlag = {\n\tenabled?: boolean;\n\tkey?: string;\n};\n\ntype FeatureFlagSnapshot = {\n\tflags?: FeatureFlag[];\n\tschema_version?: number;\n};\n\ntype FeatureFlagCache = {\n\tlastKnownSnapshot: FeatureFlagSnapshot | null;\n\tlastPath?: string;\n\tlastStatMtimeMs?: number;\n};\n\nconst featureFlagCache: FeatureFlagCache = {\n\tlastKnownSnapshot: null,\n};\n\ntype FeatureFlagEnv = {\n\tEVALOPS_FEATURE_FLAGS_PATH?: string | undefined;\n};\n\nexport const MAESTRO_EVALOPS_MANAGED_KILL_SWITCH =\n\t\"platform.kill_switches.maestro.evalops_managed\";\nexport const MAESTRO_AUTONOMOUS_ACTIONS_KILL_SWITCH =\n\t\"platform.kill_switches.maestro.autonomous_actions\";\nexport const MAESTRO_PLATFORM_RUNTIME_BRIDGE_KILL_SWITCH =\n\t\"platform.kill_switches.maestro.platform_runtime_bridge\";\nexport const MAESTRO_PLATFORM_EVENTS_KILL_SWITCH =\n\t\"platform.kill_switches.maestro.platform_events\";\nexport const MAESTRO_DRAFT_AND_CONFIRM_DEFAULT_FLAG =\n\t\"maestro.agent_authority.draft_and_confirm_default\";\nexport const MAESTRO_PLATFORM_EVENTS_PUBLISHER_FLAG =\n\t\"maestro.platform_events.publisher_enabled\";\nexport const MAESTRO_PLATFORM_RUNTIME_AGENT_RUNTIME_OBSERVE_FLAG =\n\t\"maestro.platform_runtime.agent_runtime_observe\";\nexport const MAESTRO_PLATFORM_RUNTIME_TOOL_EXECUTION_BRIDGE_FLAG =\n\t\"maestro.platform_runtime.tool_execution_bridge\";\n\nexport type FeatureFlagDecision = {\n\tkey: string;\n\tmetadata: Record<string, unknown>;\n\treason: string;\n\tvalue: boolean;\n\tvariant: string;\n};\n\nexport type ExperimentAssignment = {\n\tassigned: boolean;\n\tbucket: number;\n\texperimentId: string;\n\texposureRecorded: boolean;\n\tflagKey: string;\n\tholdoutId?: string;\n\tinHoldout: boolean;\n\tlayerId?: string;\n\tmetadata: Record<string, unknown>;\n\tnamespaceEnd: number;\n\tnamespaceStart: number;\n\treason: string;\n\tsubject: string;\n\tvariant: string;\n\tvariantBucket: number;\n};\n\nexport type FeatureFlagRequestContext = {\n\tattributes?: Record<string, string | number | boolean | null | undefined>;\n\tsubject: string;\n};\n\nexport type FeatureFlagRemoteOptions = {\n\tbaseUrl?: string;\n\theaders?: Record<string, string>;\n\ttimeoutMs?: number;\n};\n\nconst DEFAULT_IN_CLUSTER_FLAG_CONTROL_URL =\n\t\"http://flag-control-service.evalops.svc.cluster.local:8080\";\nconst DEFAULT_OUT_OF_CLUSTER_FLAG_CONTROL_URL =\n\t\"https://flags.internal.evalops.dev\";\nconst DEFAULT_REMOTE_TIMEOUT_MS = 2_000;\n\nfunction getFeatureFlagsPath(\n\tenv: FeatureFlagEnv = process.env,\n): string | undefined {\n\tconst configured = env.EVALOPS_FEATURE_FLAGS_PATH?.trim();\n\treturn configured ? configured : undefined;\n}\n\nfunction getFeatureFlagRemoteBaseUrl(): string {\n\treturn (\n\t\tprocess.env.EVALOPS_FEATURE_FLAGS_URL?.trim() ||\n\t\tprocess.env.EVALOPS_FLAG_CONTROL_URL?.trim() ||\n\t\t(process.env.KUBERNETES_SERVICE_HOST\n\t\t\t? DEFAULT_IN_CLUSTER_FLAG_CONTROL_URL\n\t\t\t: DEFAULT_OUT_OF_CLUSTER_FLAG_CONTROL_URL)\n\t).replace(/\\/+$/, \"\");\n}\n\nfunction getFeatureFlagRemoteHeaders(\n\theaders?: Record<string, string>,\n): Record<string, string> {\n\tconst merged: Record<string, string> = { ...(headers ?? {}) };\n\tconst token =\n\t\tprocess.env.EVALOPS_FEATURE_FLAGS_BEARER_TOKEN?.trim() ||\n\t\tprocess.env.EVALOPS_FLAG_CONTROL_BEARER_TOKEN?.trim();\n\tconst hasAuthorization = Object.keys(merged).some(\n\t\t(key) => key.toLowerCase() === \"authorization\",\n\t);\n\tif (token && !hasAuthorization) {\n\t\tmerged.Authorization = `Bearer ${token}`;\n\t}\n\treturn merged;\n}\n\nfunction readFeatureFlagSnapshot(\n\tenv: FeatureFlagEnv = process.env,\n): FeatureFlagSnapshot | null {\n\tconst path = getFeatureFlagsPath(env);\n\tif (!path) {\n\t\tfeatureFlagCache.lastKnownSnapshot = null;\n\t\tfeatureFlagCache.lastPath = undefined;\n\t\tfeatureFlagCache.lastStatMtimeMs = undefined;\n\t\treturn null;\n\t}\n\n\ttry {\n\t\tconst stats = statSync(path);\n\t\tif (\n\t\t\tfeatureFlagCache.lastPath === path &&\n\t\t\tfeatureFlagCache.lastStatMtimeMs === stats.mtimeMs\n\t\t) {\n\t\t\treturn featureFlagCache.lastKnownSnapshot;\n\t\t}\n\n\t\tconst snapshot = JSON.parse(\n\t\t\treadFileSync(path, \"utf8\"),\n\t\t) as FeatureFlagSnapshot;\n\t\tfeatureFlagCache.lastKnownSnapshot = snapshot;\n\t\tfeatureFlagCache.lastPath = path;\n\t\tfeatureFlagCache.lastStatMtimeMs = stats.mtimeMs;\n\t\treturn snapshot;\n\t} catch {\n\t\tif (featureFlagCache.lastPath !== path) {\n\t\t\tfeatureFlagCache.lastKnownSnapshot = null;\n\t\t}\n\t\tfeatureFlagCache.lastPath = path;\n\t\tfeatureFlagCache.lastStatMtimeMs = undefined;\n\t\treturn featureFlagCache.lastKnownSnapshot;\n\t}\n}\n\nexport function isFeatureFlagSnapshotConfigured(\n\tenv: FeatureFlagEnv = process.env,\n): boolean {\n\treturn getFeatureFlagsPath(env) !== undefined;\n}\n\nexport function isFeatureFlagEnabled(\n\tkey: string,\n\tenv: FeatureFlagEnv = process.env,\n): boolean {\n\tconst normalizedKey = key.trim();\n\tif (!normalizedKey) {\n\t\treturn false;\n\t}\n\n\tconst snapshot = readFeatureFlagSnapshot(env);\n\tif (!snapshot?.flags?.length) {\n\t\treturn false;\n\t}\n\n\treturn snapshot.flags.some(\n\t\t(flag) => flag?.key?.trim() === normalizedKey && flag.enabled === true,\n\t);\n}\n\nexport function areAutonomousActionsDisabled(): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_AUTONOMOUS_ACTIONS_KILL_SWITCH);\n}\n\nexport function isDraftAndConfirmDefaultEnabled(): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_DRAFT_AND_CONFIRM_DEFAULT_FLAG);\n}\n\nexport function isPlatformRuntimeBridgeDisabled(): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_PLATFORM_RUNTIME_BRIDGE_KILL_SWITCH);\n}\n\nexport function areMaestroPlatformEventsDisabled(\n\tenv: FeatureFlagEnv = process.env,\n): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_PLATFORM_EVENTS_KILL_SWITCH, env);\n}\n\nexport function isMaestroPlatformEventsPublisherEnabled(\n\tenv: FeatureFlagEnv = process.env,\n): boolean {\n\treturn isFeatureFlagEnabled(MAESTRO_PLATFORM_EVENTS_PUBLISHER_FLAG, env);\n}\n\nexport function isPlatformRuntimeObserveEnabled(): boolean {\n\treturn isFeatureFlagEnabled(\n\t\tMAESTRO_PLATFORM_RUNTIME_AGENT_RUNTIME_OBSERVE_FLAG,\n\t);\n}\n\nexport function isPlatformToolExecutionBridgeEnabled(): boolean {\n\treturn isFeatureFlagEnabled(\n\t\tMAESTRO_PLATFORM_RUNTIME_TOOL_EXECUTION_BRIDGE_FLAG,\n\t);\n}\n\nexport async function evaluateFeatureFlag(\n\tkey: string,\n\tcontext: FeatureFlagRequestContext,\n\tdefaultValue = false,\n\toptions: FeatureFlagRemoteOptions = {},\n): Promise<FeatureFlagDecision> {\n\tconst normalizedKey = key.trim();\n\tif (!normalizedKey) {\n\t\treturn fallbackDecision(\n\t\t\tnormalizedKey,\n\t\t\tcontext,\n\t\t\tdefaultValue,\n\t\t\t\"missing_key\",\n\t\t);\n\t}\n\n\ttry {\n\t\tconst response = await postJSON(\n\t\t\t`${remoteBaseUrl(options)}/ofrep/v1/evaluate/flags/${encodeURIComponent(normalizedKey)}`,\n\t\t\tJSON.stringify({ context: remoteContext(context) }),\n\t\t\toptions,\n\t\t);\n\t\tif (response.status === 404) {\n\t\t\treturn fallbackDecision(\n\t\t\t\tnormalizedKey,\n\t\t\t\tcontext,\n\t\t\t\tdefaultValue,\n\t\t\t\t\"not_found\",\n\t\t\t);\n\t\t}\n\t\tif (!response.ok) {\n\t\t\treturn fallbackDecision(\n\t\t\t\tnormalizedKey,\n\t\t\t\tcontext,\n\t\t\t\tdefaultValue,\n\t\t\t\t`remote_status_${response.status}`,\n\t\t\t);\n\t\t}\n\n\t\tconst payload = (await response.json()) as {\n\t\t\tkey?: string;\n\t\t\tmetadata?: Record<string, unknown>;\n\t\t\treason?: string;\n\t\t\tvalue?: unknown;\n\t\t\tvariant?: string;\n\t\t};\n\t\tif (typeof payload.value !== \"boolean\") {\n\t\t\treturn fallbackDecision(\n\t\t\t\tnormalizedKey,\n\t\t\t\tcontext,\n\t\t\t\tdefaultValue,\n\t\t\t\t\"invalid_remote_value\",\n\t\t\t);\n\t\t}\n\t\tconst metadata = getRecord(payload.metadata);\n\t\treturn {\n\t\t\tkey: payload.key?.trim() || normalizedKey,\n\t\t\tmetadata,\n\t\t\treason:\n\t\t\t\tgetString(metadata.flag_reason) || payload.reason?.trim() || \"remote\",\n\t\t\tvalue: payload.value,\n\t\t\tvariant: payload.variant?.trim() || booleanVariant(payload.value),\n\t\t};\n\t} catch (error) {\n\t\treturn fallbackDecision(\n\t\t\tnormalizedKey,\n\t\t\tcontext,\n\t\t\tdefaultValue,\n\t\t\terror instanceof Error ? error.message : \"remote_error\",\n\t\t);\n\t}\n}\n\nexport async function assignExperiment(\n\texperimentId: string,\n\tcontext: FeatureFlagRequestContext,\n\toptions: FeatureFlagRemoteOptions & {\n\t\tmetadata?: Record<string, unknown>;\n\t\trecordExposure?: boolean;\n\t} = {},\n): Promise<ExperimentAssignment> {\n\tconst normalizedExperimentId = experimentId.trim();\n\tif (!normalizedExperimentId) {\n\t\treturn missingAssignment(\n\t\t\tnormalizedExperimentId,\n\t\t\tcontext,\n\t\t\t\"missing_experiment_id\",\n\t\t);\n\t}\n\tconst subject = context.subject.trim();\n\tif (!subject) {\n\t\treturn missingAssignment(\n\t\t\tnormalizedExperimentId,\n\t\t\tcontext,\n\t\t\t\"missing_subject\",\n\t\t);\n\t}\n\n\ttry {\n\t\tconst response = await postJSON(\n\t\t\t`${remoteBaseUrl(options)}/api/experiments/${encodeURIComponent(normalizedExperimentId)}/assign`,\n\t\t\tJSON.stringify({\n\t\t\t\tcontext: remoteContext(context),\n\t\t\t\tmetadata: options.metadata ?? {},\n\t\t\t\trecord_exposure: options.recordExposure,\n\t\t\t\tsubject,\n\t\t\t}),\n\t\t\toptions,\n\t\t);\n\t\tif (response.status === 404) {\n\t\t\treturn missingAssignment(\n\t\t\t\tnormalizedExperimentId,\n\t\t\t\tcontext,\n\t\t\t\t\"missing_experiment\",\n\t\t\t);\n\t\t}\n\t\tif (!response.ok) {\n\t\t\treturn missingAssignment(\n\t\t\t\tnormalizedExperimentId,\n\t\t\t\tcontext,\n\t\t\t\t`remote_status_${response.status}`,\n\t\t\t);\n\t\t}\n\n\t\tconst payload = (await response.json()) as Record<string, unknown>;\n\t\treturn {\n\t\t\tassigned: payload.assigned === true,\n\t\t\tbucket: getNumber(payload.bucket),\n\t\t\texperimentId: getString(payload.experiment_id) || normalizedExperimentId,\n\t\t\texposureRecorded: payload.exposure_recorded === true,\n\t\t\tflagKey: getString(payload.flag_key),\n\t\t\tholdoutId: getString(payload.holdout_id) || undefined,\n\t\t\tinHoldout: payload.in_holdout === true,\n\t\t\tlayerId: getString(payload.layer_id) || undefined,\n\t\t\tmetadata: getRecord(payload.metadata),\n\t\t\tnamespaceEnd: getNumber(payload.namespace_end),\n\t\t\tnamespaceStart: getNumber(payload.namespace_start),\n\t\t\treason: getString(payload.reason) || \"remote\",\n\t\t\tsubject: getString(payload.subject) || subject,\n\t\t\tvariant: getString(payload.variant),\n\t\t\tvariantBucket: getNumber(payload.variant_bucket),\n\t\t};\n\t} catch (error) {\n\t\treturn missingAssignment(\n\t\t\tnormalizedExperimentId,\n\t\t\tcontext,\n\t\t\terror instanceof Error ? error.message : \"remote_error\",\n\t\t);\n\t}\n}\n\nfunction remoteBaseUrl(options: FeatureFlagRemoteOptions): string {\n\tconst configured = options.baseUrl?.trim().replace(/\\/+$/, \"\");\n\treturn configured || getFeatureFlagRemoteBaseUrl();\n}\n\nfunction remoteContext(\n\tcontext: FeatureFlagRequestContext,\n): Record<string, string | number | boolean> {\n\tconst remote: Record<string, string | number | boolean> = {};\n\tfor (const [key, value] of Object.entries(context.attributes ?? {})) {\n\t\tconst normalizedKey = key.trim();\n\t\tif (!normalizedKey || value == null) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (normalizedKey === \"subject\" || normalizedKey === \"targetingKey\") {\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof value === \"string\") {\n\t\t\tconst normalizedValue = value.trim();\n\t\t\tif (normalizedValue) {\n\t\t\t\tremote[normalizedKey] = normalizedValue;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tremote[normalizedKey] = value;\n\t}\n\tconst subject = context.subject.trim();\n\tif (subject) {\n\t\tremote.subject = subject;\n\t\tremote.targetingKey = subject;\n\t}\n\treturn remote;\n}\n\nfunction remoteTimeoutMs(\n\toptions: FeatureFlagRemoteOptions,\n): number | undefined {\n\tif (options.timeoutMs == null) {\n\t\treturn DEFAULT_REMOTE_TIMEOUT_MS;\n\t}\n\tif (!Number.isFinite(options.timeoutMs) || options.timeoutMs <= 0) {\n\t\treturn undefined;\n\t}\n\treturn Math.max(1, Math.trunc(options.timeoutMs));\n}\n\nasync function postJSON(\n\turl: string,\n\tbody: string,\n\toptions: FeatureFlagRemoteOptions,\n): Promise<Response> {\n\tconst controller = new AbortController();\n\tconst timeoutMs = remoteTimeoutMs(options);\n\tlet timeout: ReturnType<typeof setTimeout> | undefined;\n\tif (timeoutMs != null) {\n\t\ttimeout = setTimeout(() => controller.abort(), timeoutMs);\n\t}\n\ttry {\n\t\treturn await fetch(url, {\n\t\t\tbody,\n\t\t\theaders: {\n\t\t\t\taccept: \"application/json\",\n\t\t\t\t\"content-type\": \"application/json\",\n\t\t\t\t...getFeatureFlagRemoteHeaders(options.headers),\n\t\t\t},\n\t\t\tmethod: \"POST\",\n\t\t\tsignal: controller.signal,\n\t\t});\n\t} finally {\n\t\tif (timeout != null) {\n\t\t\tclearTimeout(timeout);\n\t\t}\n\t}\n}\n\nfunction fallbackDecision(\n\tkey: string,\n\tcontext: FeatureFlagRequestContext,\n\tdefaultValue: boolean,\n\treason: string,\n): FeatureFlagDecision {\n\treturn {\n\t\tkey,\n\t\tmetadata: {\n\t\t\tfallback_used: true,\n\t\t\tflag_subject: context.subject.trim(),\n\t\t},\n\t\treason,\n\t\tvalue: defaultValue,\n\t\tvariant: booleanVariant(defaultValue),\n\t};\n}\n\nfunction missingAssignment(\n\texperimentId: string,\n\tcontext: FeatureFlagRequestContext,\n\treason: string,\n): ExperimentAssignment {\n\treturn {\n\t\tassigned: false,\n\t\tbucket: 0,\n\t\texperimentId,\n\t\texposureRecorded: false,\n\t\tflagKey: \"\",\n\t\tinHoldout: false,\n\t\tmetadata: { fallback_used: true },\n\t\tnamespaceEnd: 0,\n\t\tnamespaceStart: 0,\n\t\treason,\n\t\tsubject: context.subject.trim(),\n\t\tvariant: \"\",\n\t\tvariantBucket: 0,\n\t};\n}\n\nfunction booleanVariant(value: boolean): string {\n\treturn value ? \"true\" : \"false\";\n}\n\nfunction getRecord(value: unknown): Record<string, unknown> {\n\treturn value != null && typeof value === \"object\" && !Array.isArray(value)\n\t\t? (value as Record<string, unknown>)\n\t\t: {};\n}\n\nfunction getString(value: unknown): string {\n\treturn typeof value === \"string\" ? value.trim() : \"\";\n}\n\nfunction getNumber(value: unknown): number {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : 0;\n}\n\nexport function resetFeatureFlagCacheForTests(): void {\n\tfeatureFlagCache.lastKnownSnapshot = null;\n\tfeatureFlagCache.lastPath = undefined;\n\tfeatureFlagCache.lastStatMtimeMs = undefined;\n}\n"]}

package/dist/config/index.d.ts

@@ -11,5 +11,5 @@
  * 5. Global config.toml (~/.maestro/config.toml)
  * 6. Built-in defaults
  */
-export { addConfiguredPackageSpecToConfig, removeConfiguredPackageSpecFromConfig, getWritablePackageConfigPath, loadConfig, loadConfiguredPackageSpecs, clearConfigCache, getAvailableProfiles, getConfigSummary, parseCliOverride, applyCliOverride, DEFAULT_CONFIG, resolveLoadedAppendSystemPromptPath, resolveProjectDocCandidateFilenames, resolvePromptLoadedProjectDocPaths, type ComposerConfig, type ConfiguredPackageSpec, type WritablePackageScope, type ApprovalPolicy, type SandboxMode, type ReasoningEffort, type ModelProviderConfig, type McpServerConfig, type FeaturesConfig, type ToolsConfig, type OtelConfig, type HistoryConfig, type TuiConfig, type ShellEnvironmentPolicy, type SandboxWorkspaceWriteConfig, type ProfileConfig, } from "./toml-config.js";
+export { addConfiguredPackageSpecToConfig, removeConfiguredPackageSpecFromConfig, getWritablePackageConfigPath, loadConfig, loadConfiguredPackageSpecs, clearConfigCache, getAvailableProfiles, getConfigSummary, parseCliOverride, applyCliOverride, DEFAULT_CONFIG, loadPromptProjectDocManifest, resolveLoadedAppendSystemPromptPath, resolveProjectDocCandidateFilenames, resolveProjectDocGlobalDirectories, resolvePromptLoadedProjectDocPaths, type ComposerConfig, type ConfiguredPackageSpec, type WritablePackageScope, type ApprovalPolicy, type SandboxMode, type ReasoningEffort, type ModelProviderConfig, type McpServerConfig, type FeaturesConfig, type ToolsConfig, type OtelConfig, type HistoryConfig, type TuiConfig, type ShellEnvironmentPolicy, type SandboxWorkspaceWriteConfig, type ProfileConfig, type PromptProjectDocManifest, type PromptProjectDocManifestEntry, type PromptProjectDocDiagnostic, type PromptProjectDocSourceKind, } from "./toml-config.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,gCAAgC,EAChC,qCAAqC,EACrC,4BAA4B,EAC5B,UAAU,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mCAAmC,EACnC,mCAAmC,EACnC,kCAAkC,EAClC,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,aAAa,GAClB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,gCAAgC,EAChC,qCAAqC,EACrC,4BAA4B,EAC5B,UAAU,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC5B,mCAAmC,EACnC,mCAAmC,EACnC,kCAAkC,EAClC,kCAAkC,EAClC,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAC/B,MAAM,kBAAkB,CAAC"}

package/dist/config/index.js

@@ -11,5 +11,5 @@
  * 5. Global config.toml (~/.maestro/config.toml)
  * 6. Built-in defaults
  */
-export { addConfiguredPackageSpecToConfig, removeConfiguredPackageSpecFromConfig, getWritablePackageConfigPath, loadConfig, loadConfiguredPackageSpecs, clearConfigCache, getAvailableProfiles, getConfigSummary, parseCliOverride, applyCliOverride, DEFAULT_CONFIG, resolveLoadedAppendSystemPromptPath, resolveProjectDocCandidateFilenames, resolvePromptLoadedProjectDocPaths, } from "./toml-config.js";
+export { addConfiguredPackageSpecToConfig, removeConfiguredPackageSpecFromConfig, getWritablePackageConfigPath, loadConfig, loadConfiguredPackageSpecs, clearConfigCache, getAvailableProfiles, getConfigSummary, parseCliOverride, applyCliOverride, DEFAULT_CONFIG, loadPromptProjectDocManifest, resolveLoadedAppendSystemPromptPath, resolveProjectDocCandidateFilenames, resolveProjectDocGlobalDirectories, resolvePromptLoadedProjectDocPaths, } from "./toml-config.js";
 //# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,gCAAgC,EAChC,qCAAqC,EACrC,4BAA4B,EAC5B,UAAU,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,mCAAmC,EACnC,mCAAmC,EACnC,kCAAkC,GAiBlC,MAAM,kBAAkB,CAAC","sourcesContent":["/**\n * Configuration Module\n *\n * Unified configuration access for Composer. Combines multiple configuration\n * sources with a clear precedence order:\n *\n * 1. CLI flags (--model, --config key=value, --profile)\n * 2. Environment variables (MAESTRO_*)\n * 3. Active TOML profile settings\n * 4. Project config.toml (.maestro/config.toml)\n * 5. Global config.toml (~/.maestro/config.toml)\n * 6. Built-in defaults\n */\n\nexport {\n\taddConfiguredPackageSpecToConfig,\n\tremoveConfiguredPackageSpecFromConfig,\n\tgetWritablePackageConfigPath,\n\tloadConfig,\n\tloadConfiguredPackageSpecs,\n\tclearConfigCache,\n\tgetAvailableProfiles,\n\tgetConfigSummary,\n\tparseCliOverride,\n\tapplyCliOverride,\n\tDEFAULT_CONFIG,\n\tresolveLoadedAppendSystemPromptPath,\n\tresolveProjectDocCandidateFilenames,\n\tresolvePromptLoadedProjectDocPaths,\n\ttype ComposerConfig,\n\ttype ConfiguredPackageSpec,\n\ttype WritablePackageScope,\n\ttype ApprovalPolicy,\n\ttype SandboxMode,\n\ttype ReasoningEffort,\n\ttype ModelProviderConfig,\n\ttype McpServerConfig,\n\ttype FeaturesConfig,\n\ttype ToolsConfig,\n\ttype OtelConfig,\n\ttype HistoryConfig,\n\ttype TuiConfig,\n\ttype ShellEnvironmentPolicy,\n\ttype SandboxWorkspaceWriteConfig,\n\ttype ProfileConfig,\n} from \"./toml-config.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACN,gCAAgC,EAChC,qCAAqC,EACrC,4BAA4B,EAC5B,UAAU,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC5B,mCAAmC,EACnC,mCAAmC,EACnC,kCAAkC,EAClC,kCAAkC,GAqBlC,MAAM,kBAAkB,CAAC","sourcesContent":["/**\n * Configuration Module\n *\n * Unified configuration access for Composer. Combines multiple configuration\n * sources with a clear precedence order:\n *\n * 1. CLI flags (--model, --config key=value, --profile)\n * 2. Environment variables (MAESTRO_*)\n * 3. Active TOML profile settings\n * 4. Project config.toml (.maestro/config.toml)\n * 5. Global config.toml (~/.maestro/config.toml)\n * 6. Built-in defaults\n */\n\nexport {\n\taddConfiguredPackageSpecToConfig,\n\tremoveConfiguredPackageSpecFromConfig,\n\tgetWritablePackageConfigPath,\n\tloadConfig,\n\tloadConfiguredPackageSpecs,\n\tclearConfigCache,\n\tgetAvailableProfiles,\n\tgetConfigSummary,\n\tparseCliOverride,\n\tapplyCliOverride,\n\tDEFAULT_CONFIG,\n\tloadPromptProjectDocManifest,\n\tresolveLoadedAppendSystemPromptPath,\n\tresolveProjectDocCandidateFilenames,\n\tresolveProjectDocGlobalDirectories,\n\tresolvePromptLoadedProjectDocPaths,\n\ttype ComposerConfig,\n\ttype ConfiguredPackageSpec,\n\ttype WritablePackageScope,\n\ttype ApprovalPolicy,\n\ttype SandboxMode,\n\ttype ReasoningEffort,\n\ttype ModelProviderConfig,\n\ttype McpServerConfig,\n\ttype FeaturesConfig,\n\ttype ToolsConfig,\n\ttype OtelConfig,\n\ttype HistoryConfig,\n\ttype TuiConfig,\n\ttype ShellEnvironmentPolicy,\n\ttype SandboxWorkspaceWriteConfig,\n\ttype ProfileConfig,\n\ttype PromptProjectDocManifest,\n\ttype PromptProjectDocManifestEntry,\n\ttype PromptProjectDocDiagnostic,\n\ttype PromptProjectDocSourceKind,\n} from \"./toml-config.js\";\n"]}

package/dist/config/toml-config.d.ts

@@ -171,6 +171,38 @@ export interface RemoveConfiguredPackageSpecOptions {
 }
 export declare const DEFAULT_CONFIG: ComposerConfig;
 export declare function resolveProjectDocCandidateFilenames(config?: ComposerConfig): string[];
+export type PromptProjectDocSourceKind = "global" | "project";
+export type PromptProjectDocDiagnosticSeverity = "info" | "warning";
+export interface PromptProjectDocManifestEntry {
+    path: string;
+    sourceKind: PromptProjectDocSourceKind;
+    scopeDir: string;
+    candidateName: string;
+    bytesRead: number;
+    truncated: boolean;
+    contentHash: string;
+    precedenceIndex: number;
+    content: string;
+    originalSize?: number;
+    maxBytes?: number;
+}
+export interface PromptProjectDocDiagnostic {
+    code: "budget_exhausted" | "duplicate_skipped" | "multiple_instruction_layers" | "read_failed" | "truncated";
+    severity: PromptProjectDocDiagnosticSeverity;
+    message: string;
+    path?: string;
+    scopeDir?: string;
+}
+export interface PromptProjectDocManifest {
+    cwd: string;
+    candidates: string[];
+    maxBytes?: number;
+    bytesRead: number;
+    entries: PromptProjectDocManifestEntry[];
+    diagnostics: PromptProjectDocDiagnostic[];
+}
+export declare function resolveProjectDocGlobalDirectories(): string[];
+export declare function loadPromptProjectDocManifest(cwdOverride?: string, config?: ComposerConfig): PromptProjectDocManifest;
 export declare function resolvePromptLoadedProjectDocPaths(cwdOverride?: string, config?: ComposerConfig): string[];
 export declare function resolveLoadedAppendSystemPromptPath(cwdOverride?: string): string | null;
 export declare function getWritablePackageConfigPath(scope: WritablePackageScope, workspaceDir?: string): string;