@sema-ai/core 1.275.1

package/dist/orchestration/workflow-script-store.js

@@ -0,0 +1,133 @@
+/**
+ * PARITY-SPOT-WORKFLOW B5/F2 (CC pretty.js:449105-449141 + `Pqi` :149631) — the script-persistence seam behind
+ * the Workflow tool's `scriptPath`/`name` calling surface. CC persists EVERY invocation's script under the
+ * session directory and returns the path in the tool result, so the model iterates by EDITING THE FILE and
+ * re-invoking with `{scriptPath}` instead of resending the whole script; `{name}` resolves a saved workflow.
+ *
+ * Core is deployment-neutral: the tool takes this seam via `RunWorkflowToolDeps.scriptStore` (optional — when
+ * absent, `scriptPath`/`name` calls get an honest structured error and inline `script` works as before). The
+ * file-backed implementation below is the TOC default (mirrors CC's session-dir posture: dir 0o700 / file
+ * 0o600, best-effort persist that never blocks a launch).
+ */
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join, resolve, sep } from "node:path";
+/** A JSON-shaped plain object (the only shape that top-level-merges; arrays/scalars replace wholesale). */
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * design/140 §6 1a — the default-args merge: **call-time args > registered defaultArgs** (the script's own
+ * internal fallbacks remain the third tier, applied by the script itself). Semantics (locked by test):
+ * - both sides plain objects → SHALLOW top-level merge (`{...defaults, ...call}`): a top-level key present in
+ *   the call args wins WHOLESALE — nested objects/arrays/scalars are replaced, never deep-merged;
+ * - call args absent (`undefined`) → the registered defaults verbatim;
+ * - call args a non-object (array / scalar / null) → the call args win wholesale (no structural mixing).
+ * Pure value-in/value-out: the caller snapshots the RESULT into the run (parse-time discipline, design/140 §2 —
+ * a resume replay never re-queries the registry; a post-launch registry change cannot reach an in-flight run).
+ */
+export function mergeWorkflowArgs(callArgs, defaultArgs) {
+    // codex F2: `defaultArgs` may be a LIVE object owned by a custom store — every path that lets it (or a
+    // nested value of it) escape into the run must clone first, or the parse-time "snapshot" is an alias the
+    // store can mutate after launch. JSON-shaped values clone cleanly; a non-cloneable value violates the
+    // seam's JSON contract and falls back to the alias (best-effort, launch must not fail on telemetry-grade
+    // hygiene).
+    const cloneDefaults = (v) => {
+        try {
+            return structuredClone(v);
+        }
+        catch {
+            return v;
+        }
+    };
+    if (callArgs === undefined)
+        return cloneDefaults(defaultArgs);
+    if (defaultArgs === undefined)
+        return callArgs;
+    if (isPlainObject(callArgs) && isPlainObject(defaultArgs)) {
+        // Object-literal spread DEFINES own properties (never walks the prototype chain), so a model-supplied
+        // `__proto__` key stays an inert own property — no pollution vector here. Defaults are cloned first so
+        // nested objects surviving the top-level merge don't alias the store's live values.
+        return { ...cloneDefaults(defaultArgs), ...callArgs };
+    }
+    return callArgs;
+}
+/**
+ * 团队通道 [426] CORE-1 — NORMALIZE a bare-string call-time arg into `{ [key]: <string> }` so the published
+ * "裸 string = <key>" ergonomic entry (built-in `team-discussion`: bare string args IS the topic) COMPOSES
+ * with a registered object `defaultArgs` instead of colliding with it.
+ *
+ * The bug it fixes: {@link mergeWorkflowArgs}'s non-object branch lets a bare string win WHOLESALE — so a
+ * named workflow whose registration carries object `defaultArgs` (center 配的 members/rounds/finalizer) had
+ * its whole defaults block silently wiped the moment a caller used the ergonomic `{name, args: "<topic>"}`
+ * form, and the collab template quietly ran as a generic advocate/skeptic. Wrapping the string here lets the
+ * subsequent object merge preserve the defaults AND honor the topic.
+ *
+ * Applied ONLY when BOTH hold (otherwise return `callArgs` untouched — pre-[426] behavior byte-preserved):
+ *  - `callArgs` is a string (the ergonomic form), AND
+ *  - `defaultArgs` is a PLAIN OBJECT (there ARE object defaults to merge under; with no/scalar defaults a bare
+ *    string must still reach the script verbatim — the built-in's own `raw === "string"` fallback handles it).
+ * `key` is the resolution's `stringArgKey` (a registry may declare which key its bare string maps to); the
+ * caller passes the built-in default `"topic"` when the resolution omits it.
+ */
+export function normalizeStringArg(callArgs, defaultArgs, key = "topic") {
+    if (typeof callArgs === "string" && isPlainObject(defaultArgs))
+        return { [key]: callArgs };
+    return callArgs;
+}
+/** Keep persisted filenames boring: runIds are `w…`/`wf_…`, saved names are caller-chosen — either way only
+ *  word chars, dot, dash (no separators, no traversal). */
+function safeFileStem(id) {
+    return /^[A-Za-z0-9._-]{1,120}$/.test(id) && !id.startsWith(".") ? id : undefined;
+}
+/**
+ * File-backed {@link WorkflowScriptStore}: scripts land as `<dir>/<runId>.js`; `resolveName` reads
+ * `<dir>/<name>.js` (same directory — a saved workflow is just a script file someone/some run left there).
+ */
+export function createFileWorkflowScriptStore(dir) {
+    const root = resolve(dir);
+    return {
+        persist(runId, script) {
+            const stem = safeFileStem(runId);
+            if (stem === undefined)
+                throw new Error(`workflow script store: unsafe runId for a filename: ${JSON.stringify(runId)}`);
+            // CC `Pqi` posture: private dir (0o700) + private file (0o600).
+            mkdirSync(root, { recursive: true, mode: 0o700 });
+            const path = join(root, `${stem}.js`);
+            writeFileSync(path, script, { encoding: "utf-8", mode: 0o600 });
+            return path;
+        },
+        load(scriptPath) {
+            // CONTAINMENT: the path is model-supplied — only files inside the store directory are readable through
+            // this seam (an arbitrary host path would turn the tool into a file-disclosure gadget).
+            const full = resolve(scriptPath);
+            if (full !== root && !full.startsWith(root + sep)) {
+                throw new Error(`workflow script store: scriptPath is outside the script store (${root})`);
+            }
+            return readFileSync(full, "utf-8");
+        },
+        resolveName(name) {
+            const stem = safeFileStem(name);
+            if (stem === undefined)
+                return undefined;
+            const path = join(root, `${stem}.js`);
+            if (!existsSync(path))
+                return undefined;
+            const script = readFileSync(path, "utf-8");
+            // design/140 §6 1a — a sibling `<name>.args.json` carries the registration's defaultArgs layer (the
+            // file-backed analog of a center-pushed default). Absent ⇒ legacy bare-script form (zero drift).
+            const argsPath = join(root, `${stem}.args.json`);
+            if (!existsSync(argsPath))
+                return script;
+            let defaultArgs;
+            try {
+                defaultArgs = JSON.parse(readFileSync(argsPath, "utf-8"));
+            }
+            catch (err) {
+                // A deployment-authored config file with broken JSON is a loud misconfig, not a silent no-default run.
+                throw new Error(`workflow script store: invalid defaultArgs JSON in ${stem}.args.json: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            return { script, defaultArgs };
+        },
+    };
+}
+//# sourceMappingURL=workflow-script-store.js.map

package/dist/orchestration/workflow-script-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-script-store.js","sourceRoot":"","sources":["../../src/orchestration/workflow-script-store.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/workflow-size-guideline.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 黑板 [663]③ — CC 2.1.202+ config key `workflowSizeGuideline`: an ADVISORY size guideline for
+ * LLM-authored workflows (small/medium/large/unrestricted), injected into the Workflow tool's
+ * prompt/description. It is guidance, NOT a cap — the hard ceiling stays `WorkflowLimits.maxAgents`.
+ *
+ * CC 2.1.206 anchors (claude-cli-2.1.206.pretty.js, all verbatim ports):
+ * - `cbd = ["unrestricted", "small", "medium", "large"]` + `Tho = { small: 5, medium: 15, large: 50 }` (:17547695)
+ * - `Hst` normalize (anything else → "unrestricted") (:17547808)
+ * - `Uvs` describe / `qvs` not-a-hard-limit sentence / `dbd` change notice / `Sho` display label /
+ *   `ubd` agent cap (:17546855-:17547120)
+ * - `Wvs` — the tool-card section; CC appends it to BOTH `prompt()` and `description()` of the
+ *   Workflow tool: `return Bvs + Wvs(Tt().workflowSizeGuideline)` (:17593321).
+ * - Snapshot semantics: CC memoizes the SESSION-START value (`pbd`) so the card is stable within a
+ *   session; a mid-session /config change reaches the model via a `workflow_size_guideline_change`
+ *   attachment (`fbd`, :19225552) rendered with `dbd`. sema v1 equivalence: the card is built once
+ *   per mount (`createRunWorkflowTool`) = per-task snapshot — same stability property.
+ *
+ * TODO(变更 reminder 面): CC's mid-session change lane (`fbd` — scan the transcript for the last
+ * `workflow_size_guideline_change` attachment, compare with the session-start snapshot, emit a new
+ * attachment rendered via `dbd`) needs a per-turn attachment channel sema's engine does not thread to
+ * this module yet. v1 ships static injection only; {@link workflowSizeGuidelineChangeNotice} (the
+ * `dbd` text, verbatim) is exported ready for that lane.
+ */
+/** CC `cbd` member type — the config value space. Unknown/absent values normalize to "unrestricted". */
+export type WorkflowSizeGuideline = "small" | "medium" | "large" | "unrestricted";
+/** CC `cbd` (:17547695) — the enum options, in CC's settings-face order. */
+export declare const WORKFLOW_SIZE_GUIDELINES: readonly WorkflowSizeGuideline[];
+/** CC `Tho` (:17547695) — the advisory agent count each tier aims under. */
+export declare const WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS: Readonly<Record<"small" | "medium" | "large", number>>;
+/** CC `Hst` — normalize any value to the guideline space; everything unknown is "unrestricted". */
+export declare function normalizeWorkflowSizeGuideline(value: unknown): WorkflowSizeGuideline;
+/** CC `ubd` — the tier's advisory agent count (undefined for "unrestricted"). CC feeds this into its
+ *  workflow-size warning thresholds; exported for the same future lane + deployments. */
+export declare function workflowSizeGuidelineAgentCap(g: WorkflowSizeGuideline): number | undefined;
+/** CC `Uvs` — the tier description embedded in the injected sentences (verbatim, em dash included). */
+export declare function describeWorkflowSizeGuideline(g: WorkflowSizeGuideline): string;
+/** CC `Sho` — the settings-face display label ("Dynamic workflow size" enum row). Exported for a
+ *  shell's settings 透传 ([663]③: the shell only surfaces the key; the engine hosts it). */
+export declare function formatWorkflowSizeGuidelineLabel(g: WorkflowSizeGuideline): string;
+/**
+ * CC `Wvs` — the section appended to the Workflow tool's prompt AND description (verbatim, including
+ * the leading blank line and the "/config" reference — the settings face both CC and sema shells
+ * expose). "unrestricted" (or unset/unknown, via `Hst` normalization) injects NOTHING — the card
+ * stays byte-identical to the guideline-less form.
+ */
+export declare function workflowSizeGuidelineSection(value: unknown): string;
+/** CC `dbd` — the mid-session change notice (verbatim). Not yet emitted by sema (see the module
+ *  TODO: needs the per-turn attachment lane CC drives via `fbd`); exported ready for it. */
+export declare function workflowSizeGuidelineChangeNotice(g: WorkflowSizeGuideline): string;
+//# sourceMappingURL=workflow-size-guideline.d.ts.map

package/dist/orchestration/workflow-size-guideline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-size-guideline.d.ts","sourceRoot":"","sources":["../../src/orchestration/workflow-size-guideline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wGAAwG;AACxG,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CAAC;AAElF,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAAiD,CAAC;AAEvH,4EAA4E;AAC5E,eAAO,MAAM,kCAAkC,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,GAAG,QAAQ,GAAG,OAAO,EAAE,MAAM,CAAC,CAIrG,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAGpF;AAED;yFACyF;AACzF,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAE1F;AAED,uGAAuG;AACvG,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAG9E;AAOD;0FAC0F;AAC1F,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAGjF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKnE;AAED;4FAC4F;AAC5F,wBAAgB,iCAAiC,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAIlF"}

package/dist/orchestration/workflow-size-guideline.js

@@ -0,0 +1,78 @@
+/**
+ * 黑板 [663]③ — CC 2.1.202+ config key `workflowSizeGuideline`: an ADVISORY size guideline for
+ * LLM-authored workflows (small/medium/large/unrestricted), injected into the Workflow tool's
+ * prompt/description. It is guidance, NOT a cap — the hard ceiling stays `WorkflowLimits.maxAgents`.
+ *
+ * CC 2.1.206 anchors (claude-cli-2.1.206.pretty.js, all verbatim ports):
+ * - `cbd = ["unrestricted", "small", "medium", "large"]` + `Tho = { small: 5, medium: 15, large: 50 }` (:17547695)
+ * - `Hst` normalize (anything else → "unrestricted") (:17547808)
+ * - `Uvs` describe / `qvs` not-a-hard-limit sentence / `dbd` change notice / `Sho` display label /
+ *   `ubd` agent cap (:17546855-:17547120)
+ * - `Wvs` — the tool-card section; CC appends it to BOTH `prompt()` and `description()` of the
+ *   Workflow tool: `return Bvs + Wvs(Tt().workflowSizeGuideline)` (:17593321).
+ * - Snapshot semantics: CC memoizes the SESSION-START value (`pbd`) so the card is stable within a
+ *   session; a mid-session /config change reaches the model via a `workflow_size_guideline_change`
+ *   attachment (`fbd`, :19225552) rendered with `dbd`. sema v1 equivalence: the card is built once
+ *   per mount (`createRunWorkflowTool`) = per-task snapshot — same stability property.
+ *
+ * TODO(变更 reminder 面): CC's mid-session change lane (`fbd` — scan the transcript for the last
+ * `workflow_size_guideline_change` attachment, compare with the session-start snapshot, emit a new
+ * attachment rendered via `dbd`) needs a per-turn attachment channel sema's engine does not thread to
+ * this module yet. v1 ships static injection only; {@link workflowSizeGuidelineChangeNotice} (the
+ * `dbd` text, verbatim) is exported ready for that lane.
+ */
+/** CC `cbd` (:17547695) — the enum options, in CC's settings-face order. */
+export const WORKFLOW_SIZE_GUIDELINES = ["unrestricted", "small", "medium", "large"];
+/** CC `Tho` (:17547695) — the advisory agent count each tier aims under. */
+export const WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS = {
+    small: 5,
+    medium: 15,
+    large: 50,
+};
+/** CC `Hst` — normalize any value to the guideline space; everything unknown is "unrestricted". */
+export function normalizeWorkflowSizeGuideline(value) {
+    if (value === "small" || value === "medium" || value === "large")
+        return value;
+    return "unrestricted";
+}
+/** CC `ubd` — the tier's advisory agent count (undefined for "unrestricted"). CC feeds this into its
+ *  workflow-size warning thresholds; exported for the same future lane + deployments. */
+export function workflowSizeGuidelineAgentCap(g) {
+    return g === "small" || g === "medium" || g === "large" ? WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS[g] : undefined;
+}
+/** CC `Uvs` — the tier description embedded in the injected sentences (verbatim, em dash included). */
+export function describeWorkflowSizeGuideline(g) {
+    if (!(g in WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS))
+        return g;
+    return `${g} — keep workflows under ${WORKFLOW_SIZE_GUIDELINE_AGENT_CAPS[g]} agents`;
+}
+/** CC `qvs` — the load-bearing "guideline, not a hard limit" sentence (verbatim). */
+function guidelineNotHardLimit() {
+    return "This is a guideline, not a hard limit — follow it unless the user's prompt calls for a different scale.";
+}
+/** CC `Sho` — the settings-face display label ("Dynamic workflow size" enum row). Exported for a
+ *  shell's settings 透传 ([663]③: the shell only surfaces the key; the engine hosts it). */
+export function formatWorkflowSizeGuidelineLabel(g) {
+    const cap = workflowSizeGuidelineAgentCap(g);
+    return cap === undefined ? g : `${g} (aim for <${cap} agents)`;
+}
+/**
+ * CC `Wvs` — the section appended to the Workflow tool's prompt AND description (verbatim, including
+ * the leading blank line and the "/config" reference — the settings face both CC and sema shells
+ * expose). "unrestricted" (or unset/unknown, via `Hst` normalization) injects NOTHING — the card
+ * stays byte-identical to the guideline-less form.
+ */
+export function workflowSizeGuidelineSection(value) {
+    const g = normalizeWorkflowSizeGuideline(value);
+    if (g !== "unrestricted")
+        return `\n\nThe user has configured a workflow size guideline in /config: ${describeWorkflowSizeGuideline(g)}. ${guidelineNotHardLimit()}`;
+    return "";
+}
+/** CC `dbd` — the mid-session change notice (verbatim). Not yet emitted by sema (see the module
+ *  TODO: needs the per-turn attachment lane CC drives via `fbd`); exported ready for it. */
+export function workflowSizeGuidelineChangeNotice(g) {
+    if (g === "unrestricted")
+        return "The user removed their workflow size guideline in /config — workflow size is unrestricted again.";
+    return `The user changed their workflow size guideline in /config: ${describeWorkflowSizeGuideline(g)}. ${guidelineNotHardLimit()}`;
+}
+//# sourceMappingURL=workflow-size-guideline.js.map

package/dist/orchestration/workflow-size-guideline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-size-guideline.js","sourceRoot":"","sources":["../../src/orchestration/workflow-size-guideline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAqC,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEvH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kCAAkC,GAA2D;IACxG,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,mGAAmG;AACnG,MAAM,UAAU,8BAA8B,CAAC,KAAc;IAC3D,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/E,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;yFACyF;AACzF,MAAM,UAAU,6BAA6B,CAAC,CAAwB;IACpE,OAAO,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9G,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,6BAA6B,CAAC,CAAwB;IACpE,IAAI,CAAC,CAAC,CAAC,IAAI,kCAAkC,CAAC;QAAE,OAAO,CAAC,CAAC;IACzD,OAAO,GAAG,CAAC,2BAA2B,kCAAkC,CAAC,CAAiC,CAAC,SAAS,CAAC;AACvH,CAAC;AAED,qFAAqF;AACrF,SAAS,qBAAqB;IAC5B,OAAO,yGAAyG,CAAC;AACnH,CAAC;AAED;0FAC0F;AAC1F,MAAM,UAAU,gCAAgC,CAAC,CAAwB;IACvE,MAAM,GAAG,GAAG,6BAA6B,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,GAAG,UAAU,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,MAAM,CAAC,GAAG,8BAA8B,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,cAAc;QACtB,OAAO,qEAAqE,6BAA6B,CAAC,CAAC,CAAC,KAAK,qBAAqB,EAAE,EAAE,CAAC;IAC7I,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;4FAC4F;AAC5F,MAAM,UAAU,iCAAiC,CAAC,CAAwB;IACxE,IAAI,CAAC,KAAK,cAAc;QACtB,OAAO,kGAAkG,CAAC;IAC5G,OAAO,8DAA8D,6BAA6B,CAAC,CAAC,CAAC,KAAK,qBAAqB,EAAE,EAAE,CAAC;AACtI,CAAC"}