@noodleseed/one 0.174.0 → 0.175.0

package/node_modules/@noodle-borg/assistant-gateway/dist/model-runtime.js

@@ -1,6 +1,9 @@
 /** Provider-neutral embedded-assistant model transport. */
 export * from './assistant-model-context.js';
 export * from './assistant-suggestions.js';
+export * from './collection-capture.js';
+export * from './collection-judgment.js';
+export * from './collection-model-call.js';
 export * from './model-error.js';
 export * from './model-probe.js';
 export * from './model-request.js';

package/node_modules/@noodle-borg/assistant-gateway/dist/portable.d.ts

@@ -24,6 +24,11 @@ export * from './channel-provider-blocks.js';
 export * from './channel-store.js';
 export * from './channel-types.js';
 export * from './channel-work.js';
+export * from './collection-ledger.js';
+export * from './collection-parsers.js';
+export * from './collection-review.js';
+export * from './collection-spec.js';
+export * from './collection-store.js';
 export * from './continuity-bounds.js';
 export * from './continuity-store.js';
 export * from './elevation.js';

package/node_modules/@noodle-borg/assistant-gateway/dist/portable.js

@@ -24,6 +24,11 @@ export * from './channel-provider-blocks.js';
 export * from './channel-store.js';
 export * from './channel-types.js';
 export * from './channel-work.js';
+export * from './collection-ledger.js';
+export * from './collection-parsers.js';
+export * from './collection-review.js';
+export * from './collection-spec.js';
+export * from './collection-store.js';
 export * from './continuity-bounds.js';
 export * from './continuity-store.js';
 export * from './elevation.js';

package/node_modules/@noodle-borg/authoring/dist/index.d.ts

@@ -12,6 +12,7 @@ export { type CustomerEndpointPolicy, type CustomerEndpointRef, customerEndpoint
 export type { DistributionImageSource, DistributionMetadataSource, DistributionMetadataV1, DistributionNegativeReviewScenarioSource, DistributionPositiveReviewScenarioSource, DistributionReviewScenarioSource, DistributionScreenshotSource, } from './distribution.js';
 export { gmailConnector } from './gmail.js';
 export { type HandoffPurpose, type HandoffSession, type HandoffStateHandleLink, handoffSession, } from './handoff.js';
+export type { CollectControl, CollectFieldOptions, ToolInteractionOptions, } from './interaction.js';
 export { algolia, file, firecrawl, type KnowledgeCrawlerDeclaration, type KnowledgeIndexDeclaration, type KnowledgeInput, knowledge, meilisearch, site, tavily, } from './knowledge.js';
 export { type ManagedCollectionDeclaration, type ManagedCollectionInput, type ManagedCollectionSource, managedCollection, } from './managed-collection.js';
 export { noodlePlatform, noodlePlatformCatalog } from './platform.js';

package/node_modules/@noodle-borg/authoring/dist/interaction.d.ts

@@ -0,0 +1,49 @@
+import type { Manifest } from '@noodle-borg/compiler';
+import type { ServerComponent } from './server.js';
+/** Standard field controls every platform renderer supports (ADR 0240, tier 0). */
+export type CollectControl = 'text' | 'textarea' | 'email' | 'phone' | 'url' | 'select' | 'consent';
+export interface CollectFieldOptions {
+    /** An input property of the action tool. */
+    readonly key: string;
+    readonly control: CollectControl;
+    /**
+     * Never enters the conversation model, transcript, logs or diagnostics. Nothing is private by
+     * default; mark each field deliberately.
+     */
+    readonly private?: true;
+    /** The person may leave it blank; the renderer submits the schema's empty value. */
+    readonly optional?: true;
+}
+/**
+ * Bounded `collect` interaction metadata (ADR 0240): one definition that a platform renderer presents
+ * with the controls each channel has, a browser form or the tool's React `view` on the website and
+ * natural collection in chat on messaging channels. It describes meaning, never layout: which fields
+ * to collect for one confirmed action, which are private, what to review, and what to say on success.
+ */
+export interface ToolInteractionOptions {
+    readonly kind: 'collect';
+    /** The confirmed action tool (`{ confirm: true }`, not read-only) this collection prepares. */
+    readonly action: ServerComponent;
+    /** Action input property -> this tool's output property that seeds it before collection starts. */
+    readonly initialValues?: Readonly<Record<string, {
+        readonly fromOutput: string;
+    }>>;
+    readonly fields: readonly CollectFieldOptions[];
+    /** Every collected value is reviewed verbatim before confirmation. */
+    readonly review: 'all';
+    /** Shown only after a known successful business outcome. */
+    readonly outcome: {
+        readonly success: string;
+    };
+    /** Shorten the channel profile's confirmation expiry (whole seconds); it can never be lengthened. */
+    readonly confirmationExpiry?: {
+        readonly seconds: number;
+    };
+}
+type ManifestToolInteraction = NonNullable<Extract<Manifest, {
+    manifestVersion: '2';
+}>['tools'][number]['interaction']>;
+/** Serialize the authored block to manifest data: the action by name, fields verbatim. */
+export declare function manifestToolInteraction(toolName: string, interaction: ToolInteractionOptions): ManifestToolInteraction;
+export {};
+//# sourceMappingURL=interaction.d.ts.map

package/node_modules/@noodle-borg/authoring/dist/interaction.js

@@ -0,0 +1,25 @@
+/** Serialize the authored block to manifest data: the action by name, fields verbatim. */
+export function manifestToolInteraction(toolName, interaction) {
+    if (interaction.action.kind !== 'tool') {
+        throw new Error(`tool "${toolName}" interaction.action must be a tool component`);
+    }
+    return {
+        kind: 'collect',
+        action: interaction.action.name,
+        ...(interaction.initialValues === undefined
+            ? {}
+            : { initialValues: { ...interaction.initialValues } }),
+        fields: interaction.fields.map((field) => ({
+            key: field.key,
+            control: field.control,
+            ...(field.private === true ? { private: true } : {}),
+            ...(field.optional === true ? { optional: true } : {}),
+        })),
+        review: 'all',
+        outcome: { success: interaction.outcome.success },
+        ...(interaction.confirmationExpiry === undefined
+            ? {}
+            : { confirmationExpiry: { seconds: interaction.confirmationExpiry.seconds } }),
+    };
+}
+//# sourceMappingURL=interaction.js.map

package/node_modules/@noodle-borg/authoring/dist/server.d.ts

@@ -8,6 +8,7 @@ import { type ConfigRef, type DeclaredVariableRef } from './config.js';
 import { type ConnectorCatalogDoc, type ConnectorRef } from './connectors.js';
 import { type ServerContextOptions } from './context.js';
 import { type CustomerAuth } from './customer-auth.js';
+import { type ToolInteractionOptions } from './interaction.js';
 import { type JsonSchema } from './json-schema.js';
 import { type KnowledgeDeclaration } from './knowledge.js';
 import * as collections from './managed-collection.js';
@@ -158,6 +159,8 @@ export interface ToolOptions {
     readonly visibility?: ('model' | 'app')[];
     /** Optional MCP Apps presentation linked to this tool. A view is metadata, not another tool kind. */
     readonly view?: ToolViewOptions;
+    /** Bounded `collect` interaction this opener declares for one confirmed action (ADR 0240). */
+    readonly interaction?: ToolInteractionOptions;
     /** Stable view identity. Defaults to `<tool>_widget`. */
     readonly viewName?: string;
     readonly viewTitle?: string;

package/node_modules/@noodle-borg/authoring/dist/server.js

@@ -9,6 +9,7 @@ import { toManifestConnectorRef } from './connections.js';
 import { validateCatalog } from './connectors.js';
 import { manifestContext } from './context.js';
 import { manifestCustomerAuth } from './customer-auth.js';
+import { manifestToolInteraction } from './interaction.js';
 import { toJsonSchema } from './json-schema.js';
 import { manifestKnowledge } from './knowledge.js';
 import * as collections from './managed-collection.js';
@@ -149,6 +150,9 @@ class ServerBuilder {
                 ...(tool.options.output ? { outputSchema: toJsonSchema(tool.options.output) } : {}),
                 ...manifestToolAnnotations(tool.options),
                 ...(tool.options.visibility?.length ? { visibility: [...tool.options.visibility] } : {}),
+                ...(tool.options.interaction
+                    ? { interaction: manifestToolInteraction(tool.name, tool.options.interaction) }
+                    : {}),
                 fulfilment: {
                     steps: recorded.steps,
                     output: recorded.output,

package/node_modules/@noodle-borg/authoring/package.json

@@ -20,16 +20,21 @@
     "./load-authored": {
       "types": "./dist/load-authored.d.ts",
       "import": "./dist/load-authored.js"
+    },
+    "./sandbox-authoring": {
+      "types": "./dist/sandbox-authoring.d.ts",
+      "import": "./dist/sandbox-authoring.js"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node ../../scripts/build-authoring-sandbox.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.type-tests.json --noEmit"
   },
   "dependencies": {
+    "@noodle-borg/compute": "0.0.0",
     "@noodle-borg/managed-capabilities": "0.0.0",
     "typescript": "^6.0.3",
     "@noodle-borg/compiler": "0.0.0",

package/node_modules/@noodle-borg/cli-catalog/dist/catalog-data-channels.js

@@ -60,7 +60,7 @@ export const CHANNELS_COMMAND = {
                 flag('support-email', 'Contact shown when an answer cannot be completed.'),
                 ...limits,
             ]),
-            leaf('doctor', 'Check deployment, storage, worker, model cost bound, and provider setup.', mutation),
+            leaf('doctor', 'Check deployment, storage, worker, model cost bound, provider setup, and capability compatibility.', mutation),
             leaf('enable', 'Enable after a successful current readiness check.', [
                 revision,
                 ...mutation,

package/node_modules/@noodle-borg/cli-catalog/dist/catalog-data-solution-drafts.js

@@ -37,6 +37,13 @@ export const SOLUTION_DRAFTS = {
     arguments: [],
     flags: [],
     subcommands: [
+        {
+            name: 'validate',
+            summary: 'Check an exact saved TypeScript revision without executing actions or publishing.',
+            arguments: [draftId],
+            flags: [...common, revision],
+            jsonOutput: { mode: 'single' },
+        },
         {
             name: 'history',
             summary: 'List source-free revisions, newest first.',

package/node_modules/@noodle-borg/cli-catalog/dist/catalog-data-solution-native-lifecycle.js

@@ -0,0 +1,43 @@
+/** Native-record lifecycle review; no automatic data migration. */
+import { INSTALLATION_ARGUMENT, OPTIONAL_FLAG, SOLUTION_COMMON_FLAGS, } from './catalog-data-solution-flags.js';
+const common = SOLUTION_COMMON_FLAGS.map((flag) => flag.name === 'org' ? { ...flag, required: true } : flag);
+export const SOLUTION_NATIVE_LIFECYCLE = {
+    name: 'lifecycle',
+    summary: 'Review and explicitly preserve available native records until erasure.',
+    arguments: [],
+    flags: [],
+    subcommands: [
+        {
+            name: 'preview',
+            summary: 'Inspect current policy and preservation counts without changing records.',
+            arguments: [INSTALLATION_ARGUMENT],
+            flags: common,
+            jsonOutput: { mode: 'single' },
+        },
+        {
+            name: 'migrate',
+            summary: 'Apply a reviewed one-way migration; never restore expired or erased records.',
+            arguments: [INSTALLATION_ARGUMENT],
+            flags: [
+                ...common,
+                {
+                    ...OPTIONAL_FLAG,
+                    name: 'preview',
+                    type: 'string',
+                    value: '<json>',
+                    required: true,
+                    summary: 'Exact preview data JSON, valid for five minutes and only while the reviewed inventory is unchanged.',
+                },
+                {
+                    ...OPTIONAL_FLAG,
+                    name: 'confirm',
+                    type: 'boolean',
+                    required: true,
+                    summary: 'Confirm preserving available and future records until explicit erasure. Activity history is unchanged.',
+                },
+            ],
+            jsonOutput: { mode: 'single' },
+        },
+    ],
+};
+//# sourceMappingURL=catalog-data-solution-native-lifecycle.js.map

package/node_modules/@noodle-borg/cli-catalog/dist/catalog-data-solution-records.js

@@ -0,0 +1,154 @@
+/** Canonical record operations and reviewed lifecycle metadata. Pure data only. */
+import { INSTALLATION_ARGUMENT, OPTIONAL_FLAG, PAGING_FLAGS, REQUIRED_ARGUMENT, SOLUTION_COMMON_FLAGS, } from './catalog-data-solution-flags.js';
+import { SOLUTION_NATIVE_LIFECYCLE } from './catalog-data-solution-native-lifecycle.js';
+export const COLLECTION_ARGUMENT = {
+    ...REQUIRED_ARGUMENT,
+    name: 'collection',
+    summary: 'Managed collection key.',
+};
+const RECORD_ARGUMENT = {
+    ...REQUIRED_ARGUMENT,
+    name: 'record',
+    summary: 'Managed record identifier.',
+};
+const RECORD_QUERY_FLAGS = [
+    {
+        ...OPTIONAL_FLAG,
+        name: 'filters',
+        type: 'string',
+        value: '<json>',
+        summary: 'JSON array of up to eight field/value equality filters, combined with AND. Only declared fields.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'sort-field',
+        type: 'string',
+        value: '<field>',
+        summary: 'Declared native collection sort field.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'sort-direction',
+        type: 'string',
+        value: '<asc|desc>',
+        summary: 'Sort direction; requires --sort-field.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'created-at-from',
+        type: 'string',
+        value: '<timestamp>',
+        summary: 'Inclusive creation-time lower bound; narrows the 10,000-record payload-query scan.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'created-at-to',
+        type: 'string',
+        value: '<timestamp>',
+        summary: 'Inclusive creation-time upper bound.',
+    },
+];
+const RECORD_FLAGS = [
+    ...SOLUTION_COMMON_FLAGS,
+    {
+        ...OPTIONAL_FLAG,
+        name: 'data',
+        type: 'string',
+        value: '<json>',
+        summary: 'Structured JSON record data.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'idempotency-key',
+        type: 'string',
+        value: '<key>',
+        summary: 'Retry-safe create key.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'expected-revision',
+        type: 'integer',
+        value: '<revision>',
+        summary: 'Expected current record revision.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'status',
+        type: 'string',
+        value: '<status>',
+        summary: 'Record status or list filter.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'assignee',
+        type: 'string',
+        value: '<subject>',
+        summary: 'Assignee subject or list filter.',
+    },
+    {
+        ...OPTIONAL_FLAG,
+        name: 'note',
+        type: 'string',
+        value: '<text>',
+        summary: 'Operator note text.',
+    },
+    ...PAGING_FLAGS,
+    {
+        ...OPTIONAL_FLAG,
+        name: 'include-deleted',
+        type: 'boolean',
+        summary: 'Include payload-free tombstones.',
+    },
+];
+export const SOLUTION_RECORDS = {
+    name: 'records',
+    summary: 'Operate one installed managed collection.',
+    arguments: [],
+    flags: [],
+    usage: 'solutions records <list|create|get|update|assign|status|note|activity|delete|migrate-schema|export|lifecycle> [options]',
+    subcommands: [
+        SOLUTION_NATIVE_LIFECYCLE,
+        ...[
+            'list',
+            'create',
+            'get',
+            'update',
+            'assign',
+            'status',
+            'note',
+            'activity',
+            'delete',
+            'migrate-schema',
+            'export',
+        ].map((name) => ({
+            name,
+            summary: name === 'activity'
+                ? 'Read native record history newest first; default 50, maximum 100, with --cursor for older pages.'
+                : name === 'migrate-schema'
+                    ? 'Administrator-only conversion of an eligible legacy request record with revision protection.'
+                    : `${name[0]?.toUpperCase()}${name.slice(1)} managed records.`,
+            arguments: [
+                INSTALLATION_ARGUMENT,
+                COLLECTION_ARGUMENT,
+                ...(name === 'list' || name === 'create' || name === 'export' ? [] : [RECORD_ARGUMENT]),
+            ],
+            flags: [
+                ...RECORD_FLAGS,
+                ...(name === 'list' ? RECORD_QUERY_FLAGS : []),
+                ...(name === 'update'
+                    ? [
+                        {
+                            ...OPTIONAL_FLAG,
+                            name: 'unset',
+                            type: 'string',
+                            value: '<fields>',
+                            summary: 'Comma-separated optional field keys to remove; cannot overlap --data. May be used without --data.',
+                        },
+                    ]
+                    : []),
+            ],
+            jsonOutput: { mode: 'single' },
+        })),
+    ],
+};
+//# sourceMappingURL=catalog-data-solution-records.js.map

package/node_modules/@noodle-borg/cli-catalog/dist/catalog-data-solution-workspace.js

@@ -1,5 +1,5 @@
 /** Fixed-role workspace administration. No execution or business permission authority lives here. */
-import { EXPECTED_REVISION, OPTIONAL_FLAG, SOLUTION_COMMON_FLAGS, } from './catalog-data-solution-flags.js';
+import { EXPECTED_REVISION, OPTIONAL_FLAG, PAGING_FLAGS, SOLUTION_COMMON_FLAGS, } from './catalog-data-solution-flags.js';
 const common = SOLUTION_COMMON_FLAGS.map((flag) => flag.name === 'org' ? { ...flag, required: true } : flag);
 const confirm = {
     ...OPTIONAL_FLAG,
@@ -27,6 +27,13 @@ export const SOLUTION_WORKSPACE = {
     arguments: [],
     flags: [],
     subcommands: [
+        {
+            name: 'list',
+            summary: 'Discover your current business workspaces without developer organization access.',
+            arguments: [],
+            flags: [...SOLUTION_COMMON_FLAGS.filter((flag) => flag.name !== 'org'), ...PAGING_FLAGS],
+            jsonOutput: { mode: 'single' },
+        },
         {
             name: 'show',
             summary: 'Inspect current workspace members, permissions and pending invitations.',

package/node_modules/@noodle-borg/cli-catalog/dist/catalog-data-solutions.js

@@ -2,6 +2,7 @@
 import { SOLUTION_DRAFTS } from './catalog-data-solution-drafts.js';
 import { AUTH_TOKEN, EXPECTED_REVISION, IDEMPOTENCY_KEY, INSTALLATION_ARGUMENT, JSON_FLAG, OPTIONAL_FLAG, PAGING_FLAGS, REQUIRED_ARGUMENT, SERVICE, SOLUTION_COMMON_FLAGS, } from './catalog-data-solution-flags.js';
 import { SOLUTION_PAGE } from './catalog-data-solution-page.js';
+import { COLLECTION_ARGUMENT, SOLUTION_RECORDS } from './catalog-data-solution-records.js';
 import { SOLUTION_WORKSPACE } from './catalog-data-solution-workspace.js';
 const APP = {
     ...OPTIONAL_FLAG,
@@ -25,105 +26,6 @@ const RETENTION = {
     summary: 'Managed-record retention in days.',
     constraints: { choices: [7, 30, 90], default: 30 },
 };
-const COLLECTION_ARGUMENT = {
-    ...REQUIRED_ARGUMENT,
-    name: 'collection',
-    summary: 'Managed collection key.',
-};
-const RECORD_ARGUMENT = {
-    ...REQUIRED_ARGUMENT,
-    name: 'record',
-    summary: 'Managed record identifier.',
-};
-const RECORD_QUERY_FLAGS = [
-    {
-        ...OPTIONAL_FLAG,
-        name: 'filters',
-        type: 'string',
-        value: '<json>',
-        summary: 'JSON array of up to eight field/value equality filters, combined with AND. Only declared fields.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'sort-field',
-        type: 'string',
-        value: '<field>',
-        summary: 'Declared native collection sort field.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'sort-direction',
-        type: 'string',
-        value: '<asc|desc>',
-        summary: 'Sort direction; requires --sort-field.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'created-at-from',
-        type: 'string',
-        value: '<timestamp>',
-        summary: 'Inclusive creation-time lower bound; narrows the 10,000-record payload-query scan.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'created-at-to',
-        type: 'string',
-        value: '<timestamp>',
-        summary: 'Inclusive creation-time upper bound.',
-    },
-];
-const RECORD_FLAGS = [
-    ...SOLUTION_COMMON_FLAGS,
-    {
-        ...OPTIONAL_FLAG,
-        name: 'data',
-        type: 'string',
-        value: '<json>',
-        summary: 'Structured JSON record data.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'idempotency-key',
-        type: 'string',
-        value: '<key>',
-        summary: 'Retry-safe create key.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'expected-revision',
-        type: 'integer',
-        value: '<revision>',
-        summary: 'Expected current record revision.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'status',
-        type: 'string',
-        value: '<status>',
-        summary: 'Record status or list filter.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'assignee',
-        type: 'string',
-        value: '<subject>',
-        summary: 'Assignee subject or list filter.',
-    },
-    {
-        ...OPTIONAL_FLAG,
-        name: 'note',
-        type: 'string',
-        value: '<text>',
-        summary: 'Operator note text.',
-    },
-    ...PAGING_FLAGS,
-    {
-        ...OPTIONAL_FLAG,
-        name: 'include-deleted',
-        type: 'boolean',
-        summary: 'Include payload-free tombstones.',
-    },
-];
 export const CATALOG_SOLUTIONS = {
     name: 'solutions',
     section: 'resources',
@@ -630,56 +532,7 @@ export const CATALOG_SOLUTIONS = {
                 },
             ],
         },
-        {
-            name: 'records',
-            summary: 'Operate one installed managed collection.',
-            arguments: [],
-            flags: [],
-            usage: 'solutions records <list|create|get|update|assign|status|note|activity|delete|migrate-schema|export> <installation> <collection> [record] [options]',
-            subcommands: [
-                ...[
-                    'list',
-                    'create',
-                    'get',
-                    'update',
-                    'assign',
-                    'status',
-                    'note',
-                    'activity',
-                    'delete',
-                    'migrate-schema',
-                    'export',
-                ].map((name) => ({
-                    name,
-                    summary: name === 'activity'
-                        ? 'Read native record history newest first; default 50, maximum 100, with --cursor for older pages.'
-                        : name === 'migrate-schema'
-                            ? 'Administrator-only conversion of an eligible legacy request record with revision protection.'
-                            : `${name[0]?.toUpperCase()}${name.slice(1)} managed records.`,
-                    arguments: [
-                        INSTALLATION_ARGUMENT,
-                        COLLECTION_ARGUMENT,
-                        ...(name === 'list' || name === 'create' || name === 'export' ? [] : [RECORD_ARGUMENT]),
-                    ],
-                    flags: [
-                        ...RECORD_FLAGS,
-                        ...(name === 'list' ? RECORD_QUERY_FLAGS : []),
-                        ...(name === 'update'
-                            ? [
-                                {
-                                    ...OPTIONAL_FLAG,
-                                    name: 'unset',
-                                    type: 'string',
-                                    value: '<fields>',
-                                    summary: 'Comma-separated optional field keys to remove; cannot overlap --data. May be used without --data.',
-                                },
-                            ]
-                            : []),
-                    ],
-                    jsonOutput: { mode: 'single' },
-                })),
-            ],
-        },
+        SOLUTION_RECORDS,
         {
             name: 'sources',
             summary: 'Inspect and control one external collection source.',

package/node_modules/@noodle-borg/compiler/dist/artifact/assemble.js

@@ -1,6 +1,6 @@
 import { artifactConfig } from './config.js';
 import { ARTIFACT_SCHEMA_VERSION, } from './types.js';
-export function assembleRuntimeArtifact({ manifest, options, runtimeBranding, runtimeShell, artifactAmbientContext, state, artifactTools, allResources, artifactPrompts, packagedAssets, requirements, declared, customerEndpoints, knowledge, managedCollections, variables, }) {
+export function assembleRuntimeArtifact({ manifest, options, runtimeBranding, runtimeShell, artifactAmbientContext, state, artifactTools, allResources, artifactPrompts, packagedAssets, requirements, declared, customerEndpoints, knowledge, managedCollections, variables, toolInteractions, }) {
     // 4. Assemble the artifact. `resources`/`prompts` and their capability lists are emitted only when
     // present, keeping a tools-only artifact byte-identical to before this slice.
     const capabilities = {
@@ -54,6 +54,7 @@ export function assembleRuntimeArtifact({ manifest, options, runtimeBranding, ru
             ...(state !== undefined ? { state } : {}),
         },
         tools: artifactTools,
+        ...(toolInteractions === undefined ? {} : { toolInteractions }),
         ...(allResources.length > 0 ? { resources: allResources } : {}),
         ...(artifactPrompts.length > 0 ? { prompts: artifactPrompts } : {}),
         ...(packagedAssets.length > 0 ? { assets: packagedAssets.map(toArtifactAsset) } : {}),

package/node_modules/@noodle-borg/compiler/dist/artifact/types.d.ts

@@ -5,6 +5,7 @@ import type { ArtifactVariableDeclaration } from '../business-variables.js';
 import type { CustomerEndpointPolicy } from '../customer-endpoint.js';
 import type { ManagedCollectionControls } from '../managed-collection-controls.js';
 import type { CondNode, ExprNode } from '../manifest/expression.js';
+import type { CollectControl } from '../manifest/interaction-schema.js';
 import type { Manifest } from '../manifest/schema.js';
 import type { OperationRef } from './operation-ref.js';
 export type { OperationRef, ResolvedCredentialBinding, ResolvedOperationRef, UnresolvedOperationRef, } from './operation-ref.js';
@@ -92,6 +93,36 @@ export interface ArtifactMeta {
     readonly ui?: WidgetUiMeta;
     readonly [key: string]: unknown;
 }
+/** One field a platform renderer collects for a `collect` interaction (ADR 0240). */
+export interface ArtifactCollectField {
+    readonly key: string;
+    readonly control: CollectControl;
+    /** Never enters the conversation model, transcript, logs or diagnostics. */
+    readonly private?: true;
+    /** May be left blank; the renderer submits the schema's empty value. */
+    readonly optional?: true;
+}
+/**
+ * Bounded interaction metadata an opener tool declares for one confirmed action (ADR 0240). Emitted
+ * under `RuntimeArtifact.toolInteractions` keyed by the opener, so the MCP-visible descriptor is
+ * unchanged; renderers exist only where the platform runs the conversation loop.
+ */
+export interface ArtifactCollectInteraction {
+    readonly kind: 'collect';
+    /** The confirmed action tool this collection prepares. */
+    readonly action: string;
+    readonly fields: readonly ArtifactCollectField[];
+    /** Action input property -> the opener output property that seeds it. */
+    readonly initialValues?: Readonly<Record<string, {
+        readonly fromOutput: string;
+    }>>;
+    readonly review: 'all';
+    readonly outcome: {
+        readonly success: string;
+    };
+    /** Developer-shortened confirmation expiry; profile defaults and the ceiling stay platform-owned. */
+    readonly confirmationExpirySeconds?: number;
+}
 export interface ArtifactToolAuthorization {
     /** Public descriptor discovery does not grant execution permission. */
     readonly discovery?: 'public';
@@ -407,6 +438,8 @@ export interface RuntimeArtifact {
     readonly source: ArtifactSource;
     readonly server: ArtifactServer;
     readonly tools: readonly ArtifactTool[];
+    /** `collect` interactions keyed by opener tool name (ADR 0240); absent when none is declared. */
+    readonly toolInteractions?: Readonly<Record<string, ArtifactCollectInteraction>>;
     readonly resources?: readonly ArtifactResource[];
     readonly prompts?: readonly ArtifactPrompt[];
     readonly assets?: readonly ArtifactPackagedAsset[];