@codemation/core 0.13.2 → 0.15.0

package/dist/index.cjs

@@ -1,8 +1,9 @@
-const require_di = require('./di-LP2qSHkY.cjs');
-const require_ItemsInputNormalizer = require('./ItemsInputNormalizer-BbQTSEkZ.cjs');
-const require_contracts = require('./contracts-CK0x6w_G.cjs');
-const require_runtime = require('./runtime-_VdHwGkJ.cjs');
-const require_InMemoryRunEventBusRegistry = require('./InMemoryRunEventBusRegistry-Sa86VxuV.cjs');
+const require_di = require('./di-C6Ubf9o5.cjs');
+const require_workflowTypes = require('./workflowTypes-BW6Hhee7.cjs');
+const require_ItemsInputNormalizer = require('./ItemsInputNormalizer-C1fv3sMW.cjs');
+const require_contracts = require('./contracts-7L1wJHdk.cjs');
+const require_runtime = require('./runtime-Due-FOZ2.cjs');
+const require_InMemoryRunEventBusRegistry = require('./InMemoryRunEventBusRegistry-DO0WM9Lw.cjs');
 let zod = require("zod");
 zod = require_di.__toESM(zod);
 let tsyringe = require("tsyringe");
@@ -100,17 +101,10 @@ function defineCredential(options) {
 
 //#endregion
 //#region src/ai/CallableToolKindToken.ts
-/**
-* Shared {@link import("../di").TypeToken} marker for {@link CallableToolConfig}.
-* Callable tools are not registered in {@link NodeResolver}; this class only satisfies {@link ToolConfig#type}.
-*/
 var CallableToolKindToken = class {};
 
 //#endregion
 //#region src/ai/CallableToolConfig.ts
-/**
-* Inline callable agent tool: DSL sugar over {@link ToolConfig} without a separate {@link NodeResolver}-registered {@link Tool} class.
-*/
 var CallableToolConfig = class {
 	type = CallableToolKindToken;
 	toolKind = "callable";
@@ -138,9 +132,6 @@ var CallableToolConfig = class {
 	getOutputSchema() {
 		return this.outputSchemaValue;
 	}
-	/**
-	* Parses tool input and output with the configured Zod schemas.
-	*/
 	async executeTool(args) {
 		const parsedInput = this.parseInput(args.input);
 		const raw = await Promise.resolve(this.executeHandler({
@@ -184,9 +175,6 @@ const CallableToolFactory = new CallableToolFactoryImpl();
 
 //#endregion
 //#region src/authoring/callableTool.types.ts
-/**
-* Workflow-facing helper for inline Zod-typed agent tools (same as {@link CallableToolFactory.callableTool}).
-*/
 function callableTool(options) {
 	return CallableToolFactory.callableTool(options);
 }
@@ -251,15 +239,9 @@ const c = {
 		return new CollectionColumnBuilderImpl("uuid");
 	}
 };
-/**
-* Validates that a name follows the required pattern: lowercase + underscores, starts with letter.
-*/
 function validateCollectionName(name) {
 	if (!/^[a-z][a-z0-9_]*$/.test(name)) throw new Error(`Collection name "${name}" must start with a lowercase letter and contain only lowercase letters, digits, and underscores.`);
 }
-/**
-* Validates that all field names follow the required pattern.
-*/
 function validateFieldNames(fields) {
 	const pattern = /^[a-z][a-z0-9_]*$/;
 	const reserved = [
@@ -272,9 +254,6 @@ function validateFieldNames(fields) {
 		if (!pattern.test(fieldName)) throw new Error(`Field name "${fieldName}" must start with a lowercase letter and contain only lowercase letters, digits, and underscores.`);
 	}
 }
-/**
-* Validates that all indexed fields exist in the declared fields.
-*/
 function validateIndexes(indexes, fieldNames) {
 	for (const index of indexes) for (const fieldName of index.on) if (!fieldNames.has(fieldName)) throw new Error(`Index references non-existent field "${fieldName}".`);
 }
@@ -348,28 +327,34 @@ const definedNodeCredentialAccessorFactory = { create(bindings, ctx) {
 
 //#endregion
 //#region src/authoring/definePollingTrigger.types.ts
-/**
-* TriggerNodeConfig produced by `DefinedPollingTrigger.create(...)`.
-* Holds user configuration and credential requirements for the engine.
-* The setup state type is opaque `JsonValue | undefined` — the runtime
-* uses an internal wrapped shape that plugin authors never see.
-*/
 var DefinedPollingTriggerConfig = class {
 	kind = "trigger";
 	type;
 	icon;
-	constructor(name, cfg, typeToken, icon, credentialRequirements, id, inspectorSummaryFn) {
+	id;
+	description;
+	constructor(name, cfg, typeToken, icon, credentialRequirements, idOrOptions, inspectorSummaryFn, defaultPollIntervalMs) {
 		this.name = name;
 		this.cfg = cfg;
 		this.credentialRequirements = credentialRequirements;
-		this.id = id;
 		this.inspectorSummaryFn = inspectorSummaryFn;
+		this.defaultPollIntervalMs = defaultPollIntervalMs;
 		this.type = typeToken;
 		this.icon = icon;
+		const resolved = typeof idOrOptions === "string" ? { id: idOrOptions } : idOrOptions;
+		this.id = resolved?.id;
+		this.description = resolved?.description;
 	}
 	getCredentialRequirements() {
 		return this.credentialRequirements;
 	}
+	getTriggerPollConfig() {
+		const resolvedInterval = this.cfg.pollIntervalMs ?? this.defaultPollIntervalMs;
+		return {
+			config: this.cfg,
+			pollIntervalMs: resolvedInterval
+		};
+	}
 	inspectorSummary() {
 		return this.inspectorSummaryFn?.({ config: this.cfg });
 	}
@@ -377,28 +362,6 @@ var DefinedPollingTriggerConfig = class {
 function isWrappedState(value) {
 	return value !== null && typeof value === "object" && "seenKeys" in value && Array.isArray(value.seenKeys);
 }
-/**
-* Declarative helper for authoring polling triggers.
-*
-* ```ts
-* export const onNewMail = definePollingTrigger({
-*   key: "my-plugin.on-new-mail",
-*   title: "On new mail",
-*   configSchema: z.object({ folder: z.string() }),
-*   credentials: { auth: myOAuthCredentialType },
-*   initialState: () => ({ lastSeenId: undefined }),
-*   pollIntervalMs: 60_000,
-*   async poll({ config, state, credentials }) {
-*     const session = await credentials.auth();
-*     const messages = await fetchMessages(session, config.folder, state.lastSeenId);
-*     return {
-*       items: messages.map(m => ({ json: m, dedupKey: m.id })),
-*       nextState: { lastSeenId: messages[0]?.id ?? state.lastSeenId },
-*     };
-*   },
-* });
-* ```
-*/
 function definePollingTrigger(options) {
 	const credentialRequirements = definedNodeCredentialRequirementFactory.create(options.credentials);
 	const DEFAULT_INTERVAL_MS = 6e4;
@@ -455,14 +418,17 @@ function definePollingTrigger(options) {
 			return [];
 		}
 	};
-	require_runtime.node({ name: options.key })(DefinedPollingTriggerRuntime);
+	require_contracts.node({
+		name: options.key,
+		packageName: options.packageName
+	})(DefinedPollingTriggerRuntime);
 	return {
 		kind: "defined-polling-trigger",
 		key: options.key,
 		title: options.title,
 		description: options.description,
-		create(cfg, name = options.title, id) {
-			return new DefinedPollingTriggerConfig(name, cfg, DefinedPollingTriggerRuntime, options.icon, credentialRequirements, id, options.inspectorSummary);
+		create(cfg, name = options.title, idOrOptions) {
+			return new DefinedPollingTriggerConfig(name, cfg, DefinedPollingTriggerRuntime, options.icon, credentialRequirements, idOrOptions, options.inspectorSummary, options.pollIntervalMs);
 		},
 		poll(pollCtx) {
 			return options.poll({
@@ -481,7 +447,7 @@ function definePollingTrigger(options) {
 //#region src/ai/AgentToolFactory.ts
 var AgentToolFactoryImpl = class {
 	asTool(node$1, options) {
-		return new require_di.NodeBackedToolConfig(options.name ?? node$1.name ?? "tool", node$1, this.withDefaultAgentInputMapper(node$1, options));
+		return new require_workflowTypes.NodeBackedToolConfig(options.name ?? node$1.name ?? "tool", node$1, this.withDefaultAgentInputMapper(node$1, options));
 	}
 	withDefaultAgentInputMapper(node$1, options) {
 		if (options.mapInput || !require_di.AgentConfigInspector.isAgentNodeConfig(node$1)) return options;
@@ -506,10 +472,6 @@ const AgentToolFactory = new AgentToolFactoryImpl();
 //#endregion
 //#region src/ai/AgentMessageConfigNormalizerFactory.ts
 var AgentMessageConfigNormalizer = class {
-	/**
-	* Prefer {@code input.messages} when present (ItemNode / engine-mapped payloads); otherwise resolve from
-	* {@link AgentNodeConfig.messages} templates.
-	*/
 	static resolveFromInputOrConfig(input, config, args) {
 		const fromInput = this.tryMessagesFromStructuredInput(input);
 		if (fromInput.length > 0) return fromInput;
@@ -558,7 +520,6 @@ var AgentMessageConfigNormalizer = class {
 
 //#endregion
 //#region src/ai/AiHost.ts
-/** Defaults aligned with common tool-agent iteration limits (many products use ~10 max rounds). */
 const AgentGuardrailDefaults = {
 	maxTurns: 10,
 	onTurnLimitReached: "error"
@@ -644,10 +605,6 @@ var WorkflowEdgePortValidator = class {
 			errors
 		};
 	}
-	/**
-	* Returns the declared output ports for a node, or null if the node is
-	* unknown / has no declared ports (legacy nodes — treat as unconstrained).
-	*/
 	allowedOutputPorts(node$1) {
 		if (!node$1) return null;
 		const declared = node$1.config.declaredOutputPorts;
@@ -658,11 +615,6 @@ var WorkflowEdgePortValidator = class {
 
 //#endregion
 //#region src/credentials/CredentialMaterialProvider.types.ts
-/**
-* Thrown by a provider when asked to operate on a `ref.source` it does not
-* handle (e.g. the local provider being asked to read `control-plane` bytes).
-* Exported so `instanceof`-checks work across the workspace boundary.
-*/
 var IllegalMaterialSourceError = class extends Error {
 	constructor(source, providerName) {
 		super(`Provider "${providerName}" cannot handle material source "${source}".`);
@@ -674,12 +626,6 @@ var IllegalMaterialSourceError = class extends Error {
 
 //#endregion
 //#region src/credentials/ManagedCredentialMaterialWriteError.ts
-/**
-* Thrown by managed-mode providers when `setMaterial` is called. Managed
-* credential bytes are owned by the control plane; the workspace must not
-* mutate them. See `docs/design/credentials-oauth-unification.md` and
-* `planning/sprints/credentials-vault/02-controlplane-material-provider.md`.
-*/
 var ManagedCredentialMaterialWriteError = class extends Error {
 	constructor(message = "managed credentials are owned by the control plane; use the Connected apps page to create or modify them.") {
 		super(message);
@@ -689,12 +635,6 @@ var ManagedCredentialMaterialWriteError = class extends Error {
 
 //#endregion
 //#region src/credentials/ManagedMaterialFetchError.ts
-/**
-* Thrown by `ControlPlaneCredentialMaterialProvider` when the control-plane
-* material endpoint returns a non-2xx response or a malformed body. Exposes
-* the HTTP status and the raw error body so call sites can surface actionable
-* detail without parsing strings.
-*/
 var ManagedMaterialFetchError = class extends Error {
 	constructor(status, providerErrorBody, message) {
 		super(message ?? `Control-plane material fetch failed: HTTP ${status} ${providerErrorBody}`);
@@ -706,9 +646,6 @@ var ManagedMaterialFetchError = class extends Error {
 
 //#endregion
 //#region src/contracts/workspaceFileTypes.ts
-/**
-* Error thrown when a requested workspace file key does not exist.
-*/
 var WorkspaceFileNotFoundError = class extends Error {
 	constructor(key) {
 		super(`Workspace file not found: ${key}`);
@@ -716,16 +653,13 @@ var WorkspaceFileNotFoundError = class extends Error {
 		this.name = "WorkspaceFileNotFoundError";
 	}
 };
-/**
-* DI token for the workspace-scoped file storage adapter.
-* Registered by `@codemation/host`; resolved by workspace-file nodes via `ctx.resolve(...)`.
-*/
 const WorkspaceFileStorageToken = Symbol.for("codemation.core.WorkspaceFileStorage");
+const WorkspaceFileRegistrarToken = Symbol.for("codemation.core.WorkspaceFileRegistrar");
 
 //#endregion
 exports.AgentBindError = require_contracts.AgentBindError;
 exports.AgentConfigInspector = require_di.AgentConfigInspector;
-exports.AgentConnectionNodeCollector = require_di.AgentConnectionNodeCollector;
+exports.AgentConnectionNodeCollector = require_workflowTypes.AgentConnectionNodeCollector;
 exports.AgentGuardrailDefaults = AgentGuardrailDefaults;
 exports.AgentMessageConfigNormalizer = AgentMessageConfigNormalizer;
 exports.AgentToolFactory = AgentToolFactory;
@@ -739,14 +673,15 @@ exports.CodemationTelemetryAttributeNames = require_runtime.CodemationTelemetryA
 exports.CodemationTelemetryMetricNames = require_runtime.CodemationTelemetryMetricNames;
 exports.ConnectionInvocationEventPublisher = require_runtime.ConnectionInvocationEventPublisher;
 exports.ConnectionInvocationIdFactory = require_runtime.ConnectionInvocationIdFactory;
-exports.ConnectionNodeIdFactory = require_di.ConnectionNodeIdFactory;
+exports.ConnectionNodeIdFactory = require_workflowTypes.ConnectionNodeIdFactory;
 exports.ControlPlaneInboxChannelToken = ControlPlaneInboxChannelToken;
 exports.CoreTokens = require_di.CoreTokens;
 exports.CostTrackingTelemetryAttributeNames = require_runtime.CostTrackingTelemetryAttributeNames;
 exports.CostTrackingTelemetryMetricNames = require_runtime.CostTrackingTelemetryMetricNames;
 exports.CredentialResolverFactory = require_runtime.CredentialResolverFactory;
-exports.CredentialUnboundError = require_di.CredentialUnboundError;
+exports.CredentialUnboundError = require_workflowTypes.CredentialUnboundError;
 exports.DEFAULT_ASSERTION_PASS_THRESHOLD = require_contracts.DEFAULT_ASSERTION_PASS_THRESHOLD;
+exports.DEPLOYMENT_MANIFEST_SCHEMA_VERSION = require_contracts.DEPLOYMENT_MANIFEST_SCHEMA_VERSION;
 exports.DefaultAsyncSleeper = require_runtime.DefaultAsyncSleeper;
 exports.DefaultExecutionBinaryService = require_runtime.DefaultExecutionBinaryService;
 exports.DefaultExecutionContextFactory = require_runtime.DefaultExecutionContextFactory;
@@ -769,7 +704,7 @@ exports.InMemoryRunDataFactory = require_runtime.InMemoryRunDataFactory;
 exports.InMemoryRunEventBus = require_InMemoryRunEventBusRegistry.InMemoryRunEventBus;
 exports.InProcessRetryRunner = require_runtime.InProcessRetryRunner;
 exports.InboxChannelResolverToken = InboxChannelResolverToken;
-exports.InjectableRuntimeDecoratorComposer = require_runtime.InjectableRuntimeDecoratorComposer;
+exports.InjectableRuntimeDecoratorComposer = require_contracts.InjectableRuntimeDecoratorComposer;
 exports.ItemExprResolver = require_runtime.ItemExprResolver;
 Object.defineProperty(exports, 'ItemsInputNormalizer', {
   enumerable: true,
@@ -790,21 +725,21 @@ exports.NoOpPollingTriggerLogger = require_runtime.NoOpPollingTriggerLogger;
 exports.NoOpTelemetryArtifactReference = require_runtime.NoOpTelemetryArtifactReference;
 exports.NoOpTelemetrySpanScope = require_runtime.NoOpTelemetrySpanScope;
 exports.NoRetryPolicy = require_runtime.NoRetryPolicy;
-exports.NodeBackedToolConfig = require_di.NodeBackedToolConfig;
+exports.NodeBackedToolConfig = require_workflowTypes.NodeBackedToolConfig;
 exports.NodeEventPublisher = require_runtime.NodeEventPublisher;
 exports.NodeIdSlugifier = require_runtime.NodeIdSlugifier;
-exports.NodeIterationIdFactory = require_di.NodeIterationIdFactory;
+exports.NodeIterationIdFactory = require_workflowTypes.NodeIterationIdFactory;
 exports.NodeOutputNormalizer = require_runtime.NodeOutputNormalizer;
-exports.PersistedRuntimeTypeMetadataStore = require_runtime.PersistedRuntimeTypeMetadataStore;
-exports.PersistedRuntimeTypeNameResolver = require_runtime.PersistedRuntimeTypeNameResolver;
+exports.PersistedRuntimeTypeMetadataStore = require_contracts.PersistedRuntimeTypeMetadataStore;
+exports.PersistedRuntimeTypeNameResolver = require_contracts.PersistedRuntimeTypeNameResolver;
 exports.PollingTriggerDedupWindow = require_runtime.PollingTriggerDedupWindow;
 exports.PollingTriggerRuntime = require_runtime.PollingTriggerRuntime;
 exports.RetryPolicy = require_runtime.RetryPolicy;
-exports.RunFinishedAtFactory = require_di.RunFinishedAtFactory;
+exports.RunFinishedAtFactory = require_workflowTypes.RunFinishedAtFactory;
 exports.RunIntentService = require_runtime.RunIntentService;
 exports.RunnableOutputBehaviorResolver = require_runtime.RunnableOutputBehaviorResolver;
-exports.StackTraceCallSitePathResolver = require_runtime.StackTraceCallSitePathResolver;
-exports.SuspensionRequest = require_di.SuspensionRequest;
+exports.StackTraceCallSitePathResolver = require_contracts.StackTraceCallSitePathResolver;
+exports.SuspensionRequest = require_workflowTypes.SuspensionRequest;
 exports.SystemClock = SystemClock;
 exports.UnavailableBinaryStorage = require_runtime.UnavailableBinaryStorage;
 exports.WhenBuilder = require_runtime.WhenBuilder;
@@ -814,11 +749,12 @@ exports.WorkflowEdgePortValidator = WorkflowEdgePortValidator;
 exports.WorkflowExecutableNodeClassifier = require_runtime.WorkflowExecutableNodeClassifier;
 exports.WorkflowExecutableNodeClassifierFactory = require_runtime.WorkflowExecutableNodeClassifierFactory;
 exports.WorkspaceFileNotFoundError = WorkspaceFileNotFoundError;
+exports.WorkspaceFileRegistrarToken = WorkspaceFileRegistrarToken;
 exports.WorkspaceFileStorageToken = WorkspaceFileStorageToken;
-exports.branchRef = require_di.branchRef;
+exports.branchRef = require_workflowTypes.branchRef;
 exports.c = c;
 exports.callableTool = callableTool;
-exports.chatModel = require_runtime.chatModel;
+exports.chatModel = require_contracts.chatModel;
 Object.defineProperty(exports, 'container', {
   enumerable: true,
   get: function () {
@@ -838,9 +774,12 @@ Object.defineProperty(exports, 'delay', {
   }
 });
 exports.deriveAssertionPassed = require_contracts.deriveAssertionPassed;
+exports.deserializeDispatch = require_contracts.deserializeDispatch;
+exports.deserializeManifest = require_contracts.deserializeManifest;
 exports.emitPorts = require_runtime.emitPorts;
+exports.emitWorkflowManifest = require_contracts.emitWorkflowManifest;
 exports.getOriginIndexFromItem = require_runtime.getOriginIndexFromItem;
-exports.getPersistedRuntimeTypeMetadata = require_runtime.getPersistedRuntimeTypeMetadata;
+exports.getPersistedRuntimeTypeMetadata = require_contracts.getPersistedRuntimeTypeMetadata;
 Object.defineProperty(exports, 'inject', {
   enumerable: true,
   get: function () {
@@ -876,8 +815,9 @@ exports.isItemExpr = require_di.isItemExpr;
 exports.isPortsEmission = require_runtime.isPortsEmission;
 exports.isUnbrandedPortsEmissionShape = require_runtime.isUnbrandedPortsEmissionShape;
 exports.itemExpr = require_di.itemExpr;
-exports.node = require_runtime.node;
-exports.nodeRef = require_di.nodeRef;
+exports.mergeForward = require_runtime.mergeForward;
+exports.node = require_contracts.node;
+exports.nodeRef = require_workflowTypes.nodeRef;
 Object.defineProperty(exports, 'predicateAwareClassFactory', {
   enumerable: true,
   get: function () {
@@ -892,11 +832,13 @@ Object.defineProperty(exports, 'registry', {
 });
 exports.resolveItemExprsForExecution = require_di.resolveItemExprsForExecution;
 exports.resolveItemExprsInUnknown = require_di.resolveItemExprsInUnknown;
+exports.serializeDispatch = require_contracts.serializeDispatch;
+exports.serializeManifest = require_contracts.serializeManifest;
 Object.defineProperty(exports, 'singleton', {
   enumerable: true,
   get: function () {
     return tsyringe.singleton;
   }
 });
-exports.tool = require_runtime.tool;
+exports.tool = require_contracts.tool;
 //# sourceMappingURL=index.cjs.map