@inf-monkeys-tech/monkeys 1.0.68 → 1.0.70

package/lib/esm/index.mjs

@@ -9236,6 +9236,12 @@ var ResolvedNavigationTargetSchema = z10.object({
   targetRevisionRef: RevisionRefSchema,
   releaseRevisionRef: RevisionRefSchema.optional()
 }).strict();
+var UnavailableNavigationTargetSchema = z10.object({
+  nodeId: ContractIdentifierSchema,
+  stableTargetRef: StableRefSchema.refine((reference) => reference.kind === "page", "Only missing Pages can be isolated."),
+  reason: z10.literal("page-missing"),
+  accessPolicy: AccessPolicySchema.nullable()
+}).strict();
 var NavigationReleaseSchema = z10.object({
   contract: z10.literal("NavigationRelease"),
   ...ReleaseBaseShape,
@@ -9245,13 +9251,17 @@ var NavigationReleaseSchema = z10.object({
     surface: ProductSurfaceSchema,
     placement: ContractIdentifierSchema
   }).strict(),
-  resolvedTargets: z10.array(ResolvedNavigationTargetSchema)
+  resolvedTargets: z10.array(ResolvedNavigationTargetSchema),
+  unavailableTargets: z10.array(UnavailableNavigationTargetSchema).optional()
 }).strict().superRefine((value, context) => {
   validateDependencySnapshot(value.dependencySnapshot, context);
   validateReleaseExpectedHead(value, "navigation-release", context);
   if (value.navigationRevisionRef.kind !== "navigation") context.addIssue({ code: "custom", path: ["navigationRevisionRef", "kind"], message: "Expected a navigation revision." });
   if (value.target.environmentRef.kind !== "environment") context.addIssue({ code: "custom", path: ["target", "environmentRef", "kind"], message: "Navigation release target requires an environment reference." });
   if (uniqueArray(value.resolvedTargets, (target) => target.nodeId)) context.addIssue({ code: "custom", path: ["resolvedTargets"], message: "Resolved Navigation node IDs must be unique." });
+  if (uniqueArray([...value.resolvedTargets, ...value.unavailableTargets ?? []], (target) => target.nodeId)) {
+    context.addIssue({ code: "custom", path: ["unavailableTargets"], message: "Navigation target resolutions must have unique node IDs." });
+  }
 });
 var RuntimeDiagnosticSchema = z10.object({
   code: ContractIdentifierSchema,
@@ -9339,7 +9349,8 @@ var CompiledNavigationDomainCommandTargetSchema = ResolvedNavigationTargetSchema
 var CompiledNavigationResolvedTargetSchema = z10.discriminatedUnion("kind", [
   CompiledNavigationTargetSchema,
   CompiledNavigationRegisteredMenuActionTargetSchema,
-  CompiledNavigationDomainCommandTargetSchema
+  CompiledNavigationDomainCommandTargetSchema,
+  UnavailableNavigationTargetSchema.omit({ reason: true }).extend({ kind: z10.literal("unavailable") }).strict()
 ]);
 var CompiledNavigationGroupNodeSchema = NavigationGroupNodeSchema.extend({
   ancestorAccessPolicies: z10.array(AccessPolicySchema)
@@ -9347,7 +9358,14 @@ var CompiledNavigationGroupNodeSchema = NavigationGroupNodeSchema.extend({
 var CompiledNavigationTargetNodeSchema = NavigationTargetNodeSchema.extend({
   ancestorAccessPolicies: z10.array(AccessPolicySchema),
   resolvedTarget: CompiledNavigationResolvedTargetSchema
-}).strict();
+}).strict().superRefine((node, context) => {
+  if (node.resolvedTarget.nodeId !== node.nodeId || stableRefIdentity(node.resolvedTarget.stableTargetRef) !== stableRefIdentity(node.targetRef)) {
+    context.addIssue({ code: "custom", path: ["resolvedTarget"], message: "Resolved target identity must match the source node." });
+  }
+  if (node.resolvedTarget.kind === "unavailable" && (node.disabled !== true || Object.keys(node.parameterMapping).length > 0)) {
+    context.addIssue({ code: "custom", path: ["resolvedTarget"], message: "Unavailable targets must be disabled and contain no executable input." });
+  }
+});
 var CompiledNavigationSeparatorNodeSchema = NavigationSeparatorNodeSchema.extend({
   ancestorAccessPolicies: z10.array(AccessPolicySchema)
 }).strict();
@@ -14845,22 +14863,75 @@ var WorkflowDefinitionSchema = z19.object({
   if (definition.revision.kind === "release" && definition.metadata.version !== definition.revision.recordVersion) context.addIssue({ code: "custom", path: ["revision", "recordVersion"], message: "Release recordVersion must equal metadata.version." });
 });
 
-// src/contracts/workflow-runtime.ts
+// src/contracts/workflow-column.ts
 import { z as z20 } from "zod";
-var WorkflowCatalogEntrySchema = z20.object({
-  contract: z20.literal("WorkflowCatalogEntry"),
+var WorkflowColumnFieldRefSchema = z20.object({
+  ontologyId: ContractIdentifierSchema,
+  fieldKey: ContractIdentifierSchema
+}).strict();
+var WorkflowColumnInputSchema = z20.discriminatedUnion("kind", [
+  z20.object({ kind: z20.literal("default") }).strict(),
+  z20.object({ kind: z20.literal("constant"), value: JsonValueSchema }).strict(),
+  z20.object({ kind: z20.literal("field"), field: WorkflowColumnFieldRefSchema }).strict(),
+  z20.object({
+    kind: z20.literal("context"),
+    field: z20.enum(["assetId", "teamId", "ontologyId", "columnId"])
+  }).strict()
+]);
+var WorkflowColumnDependencySchema = z20.discriminatedUnion("kind", [
+  z20.object({ kind: z20.literal("field"), field: WorkflowColumnFieldRefSchema }).strict(),
+  z20.object({
+    kind: z20.literal("relation"),
+    relation: WorkflowColumnFieldRefSchema,
+    direction: z20.enum(["incoming", "outgoing"]),
+    fields: z20.array(WorkflowColumnFieldRefSchema).max(100)
+  }).strict()
+]);
+var WorkflowColumnOutputPathSchema = z20.array(z20.string().min(1).max(256)).max(20);
+var WorkflowColumnOutputSchema = z20.object({
+  type: z20.enum(["number", "text", "json"]),
+  path: WorkflowColumnOutputPathSchema,
+  nullable: z20.boolean().default(false)
+}).strict();
+var WorkflowColumnBindingSchema = z20.object({
+  contract: z20.literal("WorkflowColumnBinding"),
+  version: z20.literal(1),
+  enabled: z20.boolean(),
+  paused: z20.boolean().default(false),
+  workflow: z20.object({
+    id: ContractIdentifierSchema,
+    version: z20.number().int().positive(),
+    inputSchemaHash: Sha256Schema
+  }).strict(),
+  inputs: z20.record(z20.string().min(1).max(128), WorkflowColumnInputSchema),
+  dependencies: z20.array(WorkflowColumnDependencySchema).max(100).default([]),
+  output: WorkflowColumnOutputSchema,
+  policy: z20.object({
+    debounceMs: z20.number().int().min(0).max(3e4).default(5e3),
+    maxDelayMs: z20.number().int().min(0).max(3e4).default(3e4),
+    concurrency: z20.number().int().min(1).max(32).default(2)
+  }).strict().default({ debounceMs: 5e3, maxDelayMs: 3e4, concurrency: 2 }),
+  // The workflow supplies an ISO datetime with offset for one future expiry.
+  // Scheduling infrastructure needs no knowledge of months or business periods.
+  expiry: z20.object({ path: WorkflowColumnOutputPathSchema }).strict().optional()
+}).strict();
+
+// src/contracts/workflow-runtime.ts
+import { z as z21 } from "zod";
+var WorkflowCatalogEntrySchema = z21.object({
+  contract: z21.literal("WorkflowCatalogEntry"),
   workflowId: ContractIdentifierSchema,
   teamId: ContractIdentifierSchema,
   creatorRef: EntityRefSchema,
   currentDefinitionRef: EntityRefSchema,
-  lifecycle: z20.enum(["ACTIVE", "DELETED"]),
-  asset: z20.object({
-    preset: z20.boolean(),
-    marketplacePublished: z20.boolean(),
+  lifecycle: z21.enum(["ACTIVE", "DELETED"]),
+  asset: z21.object({
+    preset: z21.boolean(),
+    marketplacePublished: z21.boolean(),
     publishConfig: JsonObjectSchema.optional(),
-    sort: z20.number().int(),
+    sort: z21.number().int(),
     forkFromRef: EntityRefSchema.optional(),
-    notAuthorized: z20.boolean()
+    notAuthorized: z21.boolean()
   }).strict(),
   createdAt: IsoDateTimeSchema,
   updatedAt: IsoDateTimeSchema,
@@ -14895,17 +14966,17 @@ var WorkflowCatalogEntrySchema = z20.object({
     });
   }
 });
-var WorkflowPublicationSchema = z20.object({
-  contract: z20.literal("WorkflowPublication"),
+var WorkflowPublicationSchema = z21.object({
+  contract: z21.literal("WorkflowPublication"),
   publicationId: ContractIdentifierSchema,
   definitionRef: EntityRefSchema,
   runtimeDefinitionRef: EntityRefSchema,
   sourceHash: Sha256Schema,
   compiledHash: Sha256Schema,
-  status: z20.enum(["PENDING", "PUBLISHED", "FAILED", "RETIRED"]),
+  status: z21.enum(["PENDING", "PUBLISHED", "FAILED", "RETIRED"]),
   publisherRef: EntityRefSchema,
   publishedAt: IsoDateTimeSchema.optional(),
-  failureReason: z20.string().trim().min(1).optional()
+  failureReason: z21.string().trim().min(1).optional()
 }).strict().superRefine((publication, context) => {
   if (publication.definitionRef.kind !== "workflow-definition") {
     context.addIssue({
@@ -14936,12 +15007,12 @@ var WorkflowPublicationSchema = z20.object({
     });
   }
 });
-var WorkflowCompletionCommitSchema = z20.object({
-  contract: z20.literal("WorkflowCompletionCommit"),
+var WorkflowCompletionCommitSchema = z21.object({
+  contract: z21.literal("WorkflowCompletionCommit"),
   commitId: ContractIdentifierSchema,
   run: ApplicationRunSchema,
-  outputs: z20.array(OutputRecordSchema),
-  artifacts: z20.array(ArtifactManifestSchema),
+  outputs: z21.array(OutputRecordSchema),
+  artifacts: z21.array(ArtifactManifestSchema),
   lineage: LineageRecordSchema,
   completedAt: IsoDateTimeSchema
 }).strict().superRefine((commit, context) => {
@@ -14983,15 +15054,15 @@ var WorkflowCompletionCommitSchema = z20.object({
     }
   });
 });
-var WorkflowCompletionReceiptSchema = z20.object({
-  contract: z20.literal("WorkflowCompletionReceipt"),
+var WorkflowCompletionReceiptSchema = z21.object({
+  contract: z21.literal("WorkflowCompletionReceipt"),
   commitId: ContractIdentifierSchema,
   runRef: EntityRefSchema,
-  outputRefs: z20.array(EntityRefSchema),
-  artifactRefs: z20.array(EntityRefSchema),
+  outputRefs: z21.array(EntityRefSchema),
+  artifactRefs: z21.array(EntityRefSchema),
   contentHash: Sha256Schema,
   committedAt: IsoDateTimeSchema,
-  idempotentReplay: z20.boolean()
+  idempotentReplay: z21.boolean()
 }).strict().superRefine((receipt, context) => {
   if (receipt.runRef.kind !== "application-run") {
     context.addIssue({
@@ -15022,6 +15093,7 @@ var WorkflowCompletionReceiptSchema = z20.object({
 
 // src/schemas/index.ts
 var canonicalContractSchemas = {
+  "workflow-column-binding": WorkflowColumnBindingSchema,
   "agent-session-command": AgentSessionCommandSchema,
   "agent-session-targeted-command": AgentSessionTargetedCommandSchema,
   "agent-session-command-result": AgentSessionCommandResultSchema,
@@ -16388,7 +16460,14 @@ var compileNavigationRuntimeBundle = (input) => {
   assertUniqueRegistryKeys(targetRegistry.map((registration) => stableRefKey(registration.stableTargetRef)), "targetRegistry");
   const targetsByStableRef = new Map(targetRegistry.map((registration) => [stableRefKey(registration.stableTargetRef), registration]));
   const releasedByNodeId = new Map(release.resolvedTargets.map((target) => [target.nodeId, target]));
+  const unavailableByNodeId = new Map((release.unavailableTargets ?? []).map((target) => [target.nodeId, target]));
   const nodesById = new Map(navigation.nodes.map((node) => [node.nodeId, node]));
+  for (const target of release.unavailableTargets ?? []) {
+    const node = nodesById.get(target.nodeId);
+    if (node?.kind !== "target" || !sameStableRef(node.targetRef, target.stableTargetRef)) {
+      throw new DeclarativeControlCompilationError("NAV_TARGET_UNRELEASED", "release.unavailableTargets", "An unavailable target must identify its source Page node exactly.");
+    }
+  }
   const nodes = orderedNavigationNodes(navigation).map((node, index) => {
     const ancestors = [];
     let parentId = node.parentNodeId;
@@ -16403,6 +16482,25 @@ var compileNavigationRuntimeBundle = (input) => {
     }
     const registration = targetsByStableRef.get(stableRefKey(node.targetRef));
     const released = releasedByNodeId.get(node.nodeId);
+    const unavailable = unavailableByNodeId.get(node.nodeId);
+    if (!registration && unavailable && node.targetRef.kind === "page" && sameStableRef(unavailable.stableTargetRef, node.targetRef)) {
+      assertTenantCompatible(node.targetRef, scope, `nodes[${index}].targetRef`);
+      if (unavailable.accessPolicy && !accessPolicyChainImplies([...ancestors, node.audience], unavailable.accessPolicy)) {
+        throw new DeclarativeControlCompilationError("AUDIENCE_WIDER_THAN_TARGET", `nodes[${index}].audience`, "Effective Navigation audience is wider than the last verified target audience.");
+      }
+      return {
+        ...node,
+        disabled: true,
+        parameterMapping: {},
+        ancestorAccessPolicies: ancestors,
+        resolvedTarget: {
+          kind: "unavailable",
+          nodeId: node.nodeId,
+          stableTargetRef: node.targetRef,
+          accessPolicy: unavailable.accessPolicy
+        }
+      };
+    }
     if (!registration || !released || !sameStableRef(registration.stableTargetRef, stableFromRevision(registration.targetRevisionRef)) || !sameStableRef(registration.stableTargetRef, released.stableTargetRef) || !sameRevisionRef(registration.targetRevisionRef, released.targetRevisionRef) || registration.kind === "route" && (Boolean(registration.releaseRevisionRef) !== Boolean(released.releaseRevisionRef) || registration.releaseRevisionRef && released.releaseRevisionRef && !sameRevisionRef(registration.releaseRevisionRef, released.releaseRevisionRef))) {
       throw new DeclarativeControlCompilationError("NAV_TARGET_UNRELEASED", `nodes[${index}].targetRef`, "Navigation target is not resolved to the exact active release recorded by NavigationRelease.");
     }
@@ -16532,6 +16630,16 @@ var resolveWorkbenchEntry = (input) => {
   return { status: "forbidden", workbenchId: "" };
 };
 
+// src/runtime/navigation-availability.ts
+var NAVIGATION_UNAVAILABLE_CAPABILITY_HEADER = "x-monkeys-navigation-capabilities";
+var NAVIGATION_UNAVAILABLE_CAPABILITY = "unavailable-pages-v1";
+function projectNavigationCompatibility(bundle, supportsUnavailable) {
+  if (supportsUnavailable || !bundle.nodes.some((node) => node.kind === "target" && node.resolvedTarget.kind === "unavailable")) return bundle;
+  const { contentHash: _hash, ...unsigned } = bundle;
+  const nodes = bundle.nodes.filter((node) => node.kind !== "target" || node.resolvedTarget.kind !== "unavailable");
+  return NavigationRuntimeBundleSchema.parse({ ...unsigned, nodes, contentHash: canonicalContentHash({ ...unsigned, nodes }) });
+}
+
 // src/runtime/menu-compiler.ts
 var MenuCompilationError = class extends Error {
   constructor(code, path, message) {
@@ -16804,6 +16912,13 @@ var compileMenuRuntimeBundle = (input) => {
   const contributionProviders = input.contributionProviders.map((registration) => MenuContributionProviderRegistrationSchema.parse(registration));
   const inputValidators = input.inputValidators ?? /* @__PURE__ */ new Map();
   const knownPermissions = new Set(input.permissionCodes.map((permission) => ContractIdentifierSchema.parse(permission)));
+  const completeApplications = new Set(input.missingPagePolicy?.completeApplicationIds.map((id) => ContractIdentifierSchema.parse(id)) ?? []);
+  const unavailableAccess = input.missingPagePolicy ? MenuAccessRequirementSchema.parse(input.missingPagePolicy.unavailableAccess) : void 0;
+  if (unavailableAccess) {
+    validatePermissionCodes(unavailableAccess.permissionAllOf, knownPermissions, "missingPagePolicy.unavailableAccess.permissionAllOf");
+    validatePermissionCodes(unavailableAccess.permissionAnyOf, knownPermissions, "missingPagePolicy.unavailableAccess.permissionAnyOf");
+  }
+  const diagnostics = [];
   pages.forEach((registration, index) => {
     if (!registration.page.visibility.productContexts.some((context) => context === registration.applicationId)) {
       throw new MenuCompilationError(
@@ -16868,6 +16983,35 @@ var compileMenuRuntimeBundle = (input) => {
       if (node.behavior.kind === "navigate") {
         const registration = pagesByKey.get(pageKey(node.behavior.page));
         if (!registration) {
+          if (unavailableAccess && completeApplications.has(node.behavior.page.applicationId)) {
+            const activationId2 = resolveMenuActivationId(node.behavior.page, node.behavior.activationId);
+            const identity2 = targetKey(node.behavior.page, activationId2);
+            const signature2 = stableSerialize2({ ...node.behavior, activationId: activationId2 });
+            const previous = targetSourceSignatures.get(identity2);
+            if (previous !== void 0 && previous !== signature2) {
+              throw new MenuCompilationError("conflicting-navigation-target", `${nodePath}.behavior`, "Missing navigation target has conflicting behavior or input.");
+            }
+            targetSourceSignatures.set(identity2, signature2);
+            if (definition.applicationId === applicationId) {
+              diagnostics.push({
+                code: "missing-page",
+                severity: "warning",
+                applicationId: definition.applicationId,
+                surface: definition.surface,
+                menuId: definition.menuId,
+                nodeId: node.nodeId,
+                page: node.behavior.page,
+                path: `${nodePath}.behavior.page`
+              });
+            }
+            const { requiredPermission: requiredPermission3, behavior: _behavior3, ...presentation3 } = node;
+            return CompiledMenuItemNodeSchema.parse({
+              ...presentation3,
+              disabled: true,
+              behavior: { kind: "navigate", page: node.behavior.page, activationId: activationId2 },
+              access: { ...unavailableAccess, requiredPermission: requiredPermission3 }
+            });
+          }
           throw new MenuCompilationError(
             "unknown-page",
             `${nodePath}.behavior.page`,
@@ -17030,6 +17174,7 @@ var compileMenuRuntimeBundle = (input) => {
   };
   return Object.freeze({
     document: deepFreeze2(document),
+    diagnostics: deepFreeze2(diagnostics),
     menusByKey,
     navigationTargetsByKey: documentTargetsByKey,
     serverInputByTargetKey,
@@ -17714,6 +17859,49 @@ var compileWorkflowPersistenceProjection = (input) => {
   });
 };
 
+// src/runtime/workflow-column.ts
+function parseWorkflowColumnBinding(value) {
+  const binding = WorkflowColumnBindingSchema.parse(value);
+  if (Object.keys(binding.inputs).length > 100)
+    throw new Error("Workflow column supports at most 100 input bindings.");
+  if (binding.policy.maxDelayMs < binding.policy.debounceMs)
+    throw new Error("Workflow column maxDelayMs must be at least debounceMs.");
+  for (const name of Object.keys(binding.inputs)) {
+    if (name !== name.trim() || name.startsWith("__") || name === "constructor" || name === "prototype") {
+      throw new Error(`Invalid Workflow input name: ${name}`);
+    }
+  }
+  return binding;
+}
+function selectOwnValue(payload, path) {
+  let value = payload;
+  for (const key of path) {
+    if (value === null || typeof value !== "object" || !Object.prototype.hasOwnProperty.call(value, key)) {
+      throw new Error(`Workflow output is missing the configured path: ${JSON.stringify(path)}`);
+    }
+    value = value[key];
+  }
+  if (value === void 0) throw new Error("Workflow output is absent.");
+  return value;
+}
+function resolveWorkflowColumnResult(binding, payload, nowMs = Date.now()) {
+  const selected = selectOwnValue(payload, binding.output.path);
+  if (selected === null && !binding.output.nullable)
+    throw new Error("Workflow output is null but this column does not allow null results.");
+  if (selected !== null) {
+    if (binding.output.type === "number" && (typeof selected !== "number" || !Number.isFinite(selected)))
+      throw new Error("Workflow output must be a finite number.");
+    if (binding.output.type === "text" && typeof selected !== "string")
+      throw new Error("Workflow output must be text.");
+  }
+  const value = JsonValueSchema.parse(selected);
+  if (!binding.expiry) return { value };
+  const expiresAt = IsoDateTimeSchema.parse(selectOwnValue(payload, binding.expiry.path));
+  if (!Number.isFinite(nowMs) || Date.parse(expiresAt) <= nowMs)
+    throw new Error("Workflow expiry must be a future datetime.");
+  return { value, expiresAt };
+}
+
 // src/runtime/access-compiler.ts
 var uniqueBy = (values, key, label) => {
   const result = /* @__PURE__ */ new Map();
@@ -18033,6 +18221,8 @@ export {
   MenuRuntimeBundleSchema,
   MenuRuntimeInputBindingSchema,
   MenuSourceInputBindingSchema,
+  NAVIGATION_UNAVAILABLE_CAPABILITY,
+  NAVIGATION_UNAVAILABLE_CAPABILITY_HEADER,
   NavigationGroupNodeSchema,
   NavigationNodeSchema,
   NavigationReleaseSchema,
@@ -18167,6 +18357,7 @@ export {
   TrendRadarCollectionSubjectRefSchema,
   TrendSourceRecordSchema,
   TrendSourceSchema,
+  UnavailableNavigationTargetSchema,
   ValidationIssueType,
   ValidationReasonType,
   ViewProviderDescriptorSchema,
@@ -18177,6 +18368,12 @@ export {
   WorkbenchRuntimeBundleSchema,
   WorkbenchSchema,
   WorkflowCatalogEntrySchema,
+  WorkflowColumnBindingSchema,
+  WorkflowColumnDependencySchema,
+  WorkflowColumnFieldRefSchema,
+  WorkflowColumnInputSchema,
+  WorkflowColumnOutputPathSchema,
+  WorkflowColumnOutputSchema,
   WorkflowCompletionCommitSchema,
   WorkflowCompletionReceiptSchema,
   WorkflowDefinitionSchema,
@@ -18245,7 +18442,9 @@ export {
   normalizeAgentMode,
   normalizeStudioAgentMode,
   parseApplicationHandoff,
+  parseWorkflowColumnBinding,
   projectAgentSessionEvents,
+  projectNavigationCompatibility,
   publishOpenApiToolCapabilityManifests,
   readApplicationHandoffFromUrl,
   readMenuActivationFromSearch,
@@ -18254,6 +18453,7 @@ export {
   resolveMenuActivationId,
   resolveThemeTokens,
   resolveWorkbenchEntry,
+  resolveWorkflowColumnResult,
   revisionRefKey,
   sameRevisionRef,
   sameStableRef,