@skaile/workspaces 4.11.0 → 4.12.0

package/dist/{chunk-REYJKU7T.js → chunk-DHMBE5J7.js}

@@ -597,15 +597,15 @@ function inspectFlowExpression(expression, requireBoolean = true) {
   const tokens = tokenize(expression);
   if (expression.trim() === "default") return [];
   const references = /* @__PURE__ */ new Map();
-  const record3 = (path, booleanOperand) => {
+  const record2 = (path, booleanOperand) => {
     references.set(path, (references.get(path) ?? false) || booleanOperand);
   };
   const context = { flow: { input: {} }, nodes: {} };
   const result = new Parser(
     tokens,
     context,
-    (path) => record3(path, false),
-    (path) => record3(path, true)
+    (path) => record2(path, false),
+    (path) => record2(path, true)
   ).parse(false);
   if (requireBoolean && typeof result !== "boolean" && result !== STATIC_BOOLEAN) {
     throw expressionError("must evaluate to a boolean");
@@ -1028,8 +1028,14 @@ function knownNonBooleanType(schema) {
   }
   return void 0;
 }
+function hasConstantlyFalsePrecondition(node) {
+  return node.contract?.requires?.some((requirement) => requirement.expr.trim() === "false") ?? false;
+}
 function optionalRefusalReason(node) {
   if (node.run.kind === "gate") return "a first-class gate node cannot be optional";
+  if (node.run.kind === "router" && !hasConstantlyFalsePrecondition(node)) {
+    return `router ${node.id} cannot be optional \u2014 skipping it would satisfy every outgoing edge at once and admit every branch instead of selecting one; only an inert placeholder router (contract.requires containing { expr: "false" }) may carry control.optional`;
+  }
   if (node.run.kind === "check") {
     return "a check node cannot be optional \u2014 an optional verification either hides a false green (escalate) or hangs the run forever (fail); reject the check entirely if it should not gate the run";
   }
@@ -1304,365 +1310,7 @@ function validateClassifierRules(flow, context) {
     }
   }
 }
-var successfullyParsedDefinitions = /* @__PURE__ */ new WeakMap();
-function valueFingerprint(value, ancestors) {
-  if (value === null) return "null";
-  if (value === void 0) return "undefined";
-  if (typeof value === "string") return `string:${JSON.stringify(value)}`;
-  if (typeof value === "boolean") return `boolean:${value}`;
-  if (typeof value === "number") {
-    if (!Number.isFinite(value)) return null;
-    return `number:${Object.is(value, -0) ? "-0" : value}`;
-  }
-  if (typeof value !== "object" || ancestors.has(value)) return null;
-  ancestors.add(value);
-  try {
-    if (Array.isArray(value)) {
-      if (Object.getPrototypeOf(value) !== Array.prototype) return null;
-      if (Object.getOwnPropertySymbols(value).length > 0) return null;
-      const names = Object.getOwnPropertyNames(value);
-      if (names.length !== value.length + 1 || !names.includes("length")) return null;
-      const items = [];
-      for (let index = 0; index < value.length; index += 1) {
-        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
-        if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) return null;
-        const item = valueFingerprint(descriptor.value, ancestors);
-        if (item === null) return null;
-        items.push(item);
-      }
-      return `array:[${items.join(",")}]`;
-    }
-    const prototype = Object.getPrototypeOf(value);
-    if (prototype !== Object.prototype && prototype !== null) return null;
-    if (Object.getOwnPropertySymbols(value).length > 0) return null;
-    const entries = [];
-    for (const key of Object.getOwnPropertyNames(value).sort()) {
-      const descriptor = Object.getOwnPropertyDescriptor(value, key);
-      if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) return null;
-      const nested = valueFingerprint(descriptor.value, ancestors);
-      if (nested === null) return null;
-      entries.push(`${JSON.stringify(key)}:${nested}`);
-    }
-    return `object:{${entries.join(",")}}`;
-  } finally {
-    ancestors.delete(value);
-  }
-}
-function definitionFingerprint(data) {
-  return valueFingerprint(data, /* @__PURE__ */ new Set());
-}
-var LegacyRouteSchema = z.looseObject({
-  condition: z.string().min(1),
-  target: z.string().min(1).nullable()
-});
-var LegacyNodeDataSchema = z.looseObject({
-  skill: z.string().min(1).optional(),
-  version: z.string().min(1).optional(),
-  label: z.string().min(1).optional(),
-  description: z.string().min(1).optional(),
-  optional: z.boolean().optional(),
-  approval: z.looseObject({ mandatory: z.boolean().optional() }).optional(),
-  parameters: z.record(z.string(), z.unknown()).optional(),
-  phase: z.string().min(1).optional(),
-  parallel_group: z.string().min(1).optional(),
-  flow: z.string().min(1).optional(),
-  pass_context: z.boolean().optional(),
-  message: z.string().min(1).optional(),
-  routes: z.array(LegacyRouteSchema).optional(),
-  assets: z.array(z.string().min(1)).optional()
-});
-var LegacyNodeSchema = z.looseObject({
-  id: z.string().min(1),
-  type: z.string().min(1).optional(),
-  skill: z.string().min(1).optional(),
-  label: z.string().min(1).optional(),
-  description: z.string().min(1).optional(),
-  data: LegacyNodeDataSchema.optional()
-});
-var LegacyEdgeSchema = z.looseObject({
-  id: z.string().min(1).optional(),
-  source: z.string().min(1),
-  target: z.string().min(1),
-  type: z.string().min(1).optional()
-});
-var LegacyFlowSchema = z.looseObject({
-  id: z.string().min(1),
-  version: z.string().min(1).optional(),
-  name: z.string().min(1),
-  description: z.string().min(1).optional(),
-  requires: z.array(z.string().min(1)).optional(),
-  globals: z.record(z.string(), z.unknown()).optional(),
-  entry: z.string().min(1).optional(),
-  nodes: z.array(LegacyNodeSchema).optional(),
-  edges: z.array(LegacyEdgeSchema).optional(),
-  meta: z.record(z.string(), z.unknown()).optional(),
-  metadata: z.record(z.string(), z.unknown()).optional()
-});
-function success(data) {
-  const fingerprint = definitionFingerprint(data);
-  if (fingerprint !== null) successfullyParsedDefinitions.set(data, fingerprint);
-  return { ok: true, data };
-}
-function failure(error) {
-  return {
-    ok: false,
-    errors: error.issues.map((issue) => ({
-      path: issue.path.map(String).join("."),
-      message: issue.message
-    }))
-  };
-}
-var LEGACY_DEFAULT_KEYS = {
-  approval_mode: "approval",
-  research_depth: "researchDepth",
-  auto_review: "autoReview",
-  verbosity: "verbosity",
-  cli_mode: "cliMode",
-  run_input: "run_input"
-};
-var DROPPED_LEGACY_DEFAULT_KEYS = /* @__PURE__ */ new Set(["subagent_mode"]);
-function normalizeDefaults(globals) {
-  if (!globals) return void 0;
-  const known = {};
-  const parameters = {};
-  for (const [key, value] of Object.entries(globals)) {
-    if (DROPPED_LEGACY_DEFAULT_KEYS.has(key)) continue;
-    const normalizedKey = LEGACY_DEFAULT_KEYS[key];
-    if (normalizedKey) {
-      known[normalizedKey] = key === "approval_mode" && value === "auto_approve" ? "auto" : value;
-    } else {
-      parameters[key] = value;
-    }
-  }
-  if (Object.keys(parameters).length > 0) known.parameters = parameters;
-  return Object.keys(known).length > 0 ? known : void 0;
-}
-function normalizeMeta(value) {
-  if (!value) return void 0;
-  const meta = {};
-  if (typeof value.icon === "string") meta.icon = value.icon;
-  if (typeof value.category === "string") meta.category = value.category;
-  if (Array.isArray(value.tags)) meta.tags = value.tags;
-  if (typeof value.stage === "string") meta.stage = value.stage;
-  if (typeof value.onboarding === "object" && value.onboarding !== null) {
-    const onboarding = value.onboarding;
-    if (onboarding.input_style === "freeform" || onboarding.input_style === "structured" || onboarding.input_style === "repo") {
-      meta.onboarding = {
-        input_style: onboarding.input_style,
-        ...typeof onboarding.placeholder === "string" ? { placeholder: onboarding.placeholder } : {},
-        ...Array.isArray(onboarding.fields) ? { fields: onboarding.fields } : {}
-      };
-    }
-  }
-  return Object.keys(meta).length > 0 ? meta : void 0;
-}
-function normalizeLegacyBinding(value) {
-  if (typeof value === "string") {
-    return value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_match, key) => {
-      const normalized = LEGACY_DEFAULT_KEYS[key];
-      return `\${defaults.${normalized ?? `parameters.${key}`}}`;
-    });
-  }
-  if (Array.isArray(value)) return value.map(normalizeLegacyBinding);
-  if (typeof value !== "object" || value === null) return value;
-  return Object.fromEntries(
-    Object.entries(value).map(([key, nested]) => [key, normalizeLegacyBinding(nested)])
-  );
-}
-function renderLegacyCheck(check) {
-  try {
-    return JSON.stringify(check) ?? String(check);
-  } catch {
-    return String(check);
-  }
-}
-var LEGACY_GATE_ON_FAIL = "pause-for-human";
-function normalizeLegacyGate(node, index, label, description) {
-  const data = node.data ?? {};
-  const raw = data;
-  const refuse = (field, message) => ({
-    ok: false,
-    error: { path: `nodes.${index}.data.${field}`, message }
-  });
-  if (data.optional === true) {
-    return refuse("optional", `gate ${node.id} cannot be optional \u2014 a skippable gate never gates`);
-  }
-  if (raw.on_fail !== void 0 && raw.on_fail !== LEGACY_GATE_ON_FAIL) {
-    return refuse(
-      "on_fail",
-      `gate ${node.id} has unsupported on_fail ${JSON.stringify(raw.on_fail)}; only "${LEGACY_GATE_ON_FAIL}" can be preserved`
-    );
-  }
-  const check = raw.check === void 0 || raw.check === null || raw.check === "" ? void 0 : typeof raw.check === "string" ? raw.check : renderLegacyCheck(raw.check);
-  const basePrompt = data.message ?? description;
-  const prompt = check !== void 0 ? `${basePrompt}
-
-Approval criterion (not evaluated automatically): ${check}` : basePrompt;
-  return {
-    ok: true,
-    node: {
-      id: node.id,
-      label,
-      description,
-      phase: data.phase,
-      run: {
-        kind: "gate",
-        prompt,
-        schema: { kind: "text" },
-        assets: data.assets && data.assets.length > 0 ? [...new Set(data.assets)] : void 0
-      },
-      // No `contract.input`: a gate resolves no bindings, so v1 parameters would be dead weight.
-      control: data.parallel_group ? { parallelGroup: data.parallel_group } : void 0
-    }
-  };
-}
-function normalizeV1(data) {
-  const legacyResult = LegacyFlowSchema.safeParse(data);
-  if (!legacyResult.success) return failure(legacyResult.error);
-  const legacy = legacyResult.data;
-  const contradiction = (legacy.nodes ?? []).findIndex(
-    (node) => node.data?.optional === true && node.data.approval?.mandatory === true
-  );
-  if (contradiction !== -1) {
-    return {
-      ok: false,
-      errors: [
-        {
-          path: `nodes.${contradiction}.data`,
-          message: "a node cannot be both optional and a mandatory approval gate"
-        }
-      ]
-    };
-  }
-  const nodes = [];
-  for (const [index, node] of (legacy.nodes ?? []).entries()) {
-    const data2 = node.data ?? {};
-    const kind = node.type;
-    const label = data2.label ?? node.label ?? data2.skill ?? node.skill ?? node.id;
-    const description = node.description ?? data2.description ?? data2.message ?? label;
-    if (kind === "sub-flow" && data2.flow) {
-      const delegatedAsset = `flow:${data2.flow}`;
-      const assets2 = [.../* @__PURE__ */ new Set([delegatedAsset, ...data2.assets ?? []])];
-      const parameters2 = data2.parameters ?? {};
-      const control2 = {
-        optional: data2.optional,
-        parallelGroup: data2.parallel_group
-      };
-      nodes.push({
-        id: node.id,
-        label,
-        description,
-        phase: data2.phase,
-        run: {
-          kind: "sub-flow",
-          flow: data2.flow,
-          passContext: data2.pass_context,
-          assets: assets2
-        },
-        contract: Object.keys(parameters2).length > 0 ? { input: normalizeLegacyBinding(parameters2) } : void 0,
-        control: Object.values(control2).some((value) => value !== void 0) ? control2 : void 0
-      });
-      continue;
-    }
-    if (kind === "gate") {
-      const gateResult = normalizeLegacyGate(node, index, label, description);
-      if (!gateResult.ok) return { ok: false, errors: [gateResult.error] };
-      nodes.push(gateResult.node);
-      continue;
-    }
-    if (kind !== "skill") {
-      const delegatedAsset = kind === "sub-flow" && data2.flow ? `flow:${data2.flow}` : void 0;
-      const assets2 = [
-        .../* @__PURE__ */ new Set([...delegatedAsset ? [delegatedAsset] : [], ...data2.assets ?? []])
-      ];
-      const parameters2 = data2.parameters ?? {};
-      nodes.push({
-        id: node.id,
-        label,
-        description,
-        phase: data2.phase,
-        run: {
-          kind: "router",
-          routes: [{ when: "default", target: null }],
-          assets: assets2.length > 0 ? assets2 : void 0
-        },
-        contract: {
-          requires: [{ expr: "false" }],
-          input: Object.keys(parameters2).length > 0 ? normalizeLegacyBinding(parameters2) : void 0
-        },
-        control: { optional: true, parallelGroup: data2.parallel_group }
-      });
-      continue;
-    }
-    const parameters = { ...data2.parameters ?? {} };
-    const authoredInstruction = parameters.instructions;
-    delete parameters.instructions;
-    const instruction = typeof authoredInstruction === "string" && authoredInstruction.length > 0 ? authoredInstruction : description;
-    const skill = data2.skill ?? node.skill;
-    const skillAsset = skill ? `skill:${skill}${data2.version !== void 0 ? `#${data2.version}` : ""}` : void 0;
-    const assets = [...skillAsset ? [skillAsset] : [], ...data2.assets ?? []];
-    const control = {
-      optional: data2.optional,
-      parallelGroup: data2.parallel_group
-    };
-    nodes.push({
-      id: node.id,
-      label,
-      description,
-      phase: data2.phase,
-      run: {
-        kind: "agent",
-        instruction,
-        assets: assets.length > 0 ? assets : void 0
-      },
-      contract: Object.keys(parameters).length > 0 ? { input: normalizeLegacyBinding(parameters) } : void 0,
-      gate: data2.approval?.mandatory === true ? { approval: "mandatory" } : void 0,
-      control: Object.values(control).some((value) => value !== void 0) ? control : void 0
-    });
-  }
-  const nodeIds = new Set(nodes.map((node) => node.id));
-  const edges = (legacy.edges ?? []).map((edge, index) => ({
-    ...edge,
-    id: edge.id ?? `${edge.source}-${edge.target}-${index}`,
-    type: edge.type ?? "optional"
-  }));
-  const anchor = nodes.find((node) => node.id === legacy.entry) ?? (nodes.length > 0 ? nodes[0] : void 0);
-  if (anchor && legacy.requires && legacy.requires.length > 0) {
-    const run = anchor.run;
-    const existingAssets = Array.isArray(run.assets) ? run.assets : [];
-    run.assets = [.../* @__PURE__ */ new Set([...existingAssets, ...legacy.requires])];
-  }
-  const candidate = {
-    schemaVersion: 2,
-    id: legacy.id,
-    version: legacy.version ?? "1.0.0",
-    name: legacy.name,
-    description: legacy.description,
-    defaults: normalizeDefaults(legacy.globals),
-    entry: legacy.entry !== void 0 && nodeIds.has(legacy.entry) ? legacy.entry : void 0,
-    nodes,
-    edges,
-    meta: normalizeMeta({ ...legacy.metadata ?? {}, ...legacy.meta ?? {} })
-  };
-  const normalized = parseFlowDefinitionStructure({ ...candidate, edges: [] });
-  if (!normalized.success) return failure(normalized.error);
-  const parsed = { ...normalized.data, edges };
-  return success(parsed);
-}
-function parseFlowDefinition(data) {
-  if (typeof data === "object" && data !== null) {
-    const recorded = successfullyParsedDefinitions.get(data);
-    if (recorded !== void 0 && definitionFingerprint(data) === recorded) {
-      return { ok: true, data };
-    }
-  }
-  if (typeof data === "object" && data !== null && Object.hasOwn(data, "schemaVersion")) {
-    const result = FlowDefinitionSchema.safeParse(data);
-    return result.success ? success(result.data) : failure(result.error);
-  }
-  return normalizeV1(data);
-}
 
-export { FLOW_EXPRESSION_LIMITS, FlowDefinitionSchema, FlowExpressionError, InputSchema, RESERVED_CLASSIFIER_FIELDS, checkClassifierShape, classifierDecision, collectFlowBindingExpressions, declaresReservedClassifierField, evaluate, evaluateFlowExpression, inspectFlowExpression, inspectFlowExpressionComparisons, normalizeV1, parseFlowDefinition, resolveFlowBindings, stableFlowJson, withoutReservedClassifierFields };
-//# sourceMappingURL=chunk-REYJKU7T.js.map
-//# sourceMappingURL=chunk-REYJKU7T.js.map
+export { FLOW_EXPRESSION_LIMITS, FlowDefinitionSchema, FlowExpressionError, InputSchema, RESERVED_CLASSIFIER_FIELDS, checkClassifierShape, classifierDecision, collectFlowBindingExpressions, declaresReservedClassifierField, evaluate, evaluateFlowExpression, hasConstantlyFalsePrecondition, inspectFlowExpression, inspectFlowExpressionComparisons, parseFlowDefinitionStructure, resolveFlowBindings, stableFlowJson, withoutReservedClassifierFields };
+//# sourceMappingURL=chunk-DHMBE5J7.js.map
+//# sourceMappingURL=chunk-DHMBE5J7.js.map