@noodleseed/one 0.35.2 → 0.37.0

package/node_modules/@noodle-borg/runtime/dist/invocation-context.d.ts

@@ -0,0 +1,22 @@
+export type InvocationContextPreferenceSource = 'user-preference' | 'client-hint' | 'server-default' | 'platform-default';
+export interface InvocationTemporalContext {
+    /** Server-authoritative RFC 3339 instant. */
+    readonly instant: string;
+    readonly localDate: string;
+    readonly localTime: string;
+    readonly utcOffset: string;
+    readonly weekday: string;
+    readonly timeZone: string;
+    readonly locale: string;
+    readonly source: {
+        readonly locale: InvocationContextPreferenceSource;
+        readonly timeZone: InvocationContextPreferenceSource;
+    };
+}
+/** Immutable facts resolved once and reused for every fulfilment in one invocation. */
+export interface InvocationContext {
+    readonly temporal: InvocationTemporalContext;
+    readonly ambientStatus: 'not_configured' | 'available' | 'unavailable';
+    readonly ambient?: unknown;
+}
+//# sourceMappingURL=invocation-context.d.ts.map

package/node_modules/@noodle-borg/runtime/dist/invocation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-context.d.ts","sourceRoot":"","sources":["../src/invocation-context.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iCAAiC,GACzC,iBAAiB,GACjB,aAAa,GACb,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;QACnD,QAAQ,CAAC,QAAQ,EAAE,iCAAiC,CAAC;KACtD,CAAC;CACH;AAED,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,WAAW,GAAG,aAAa,CAAC;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/node_modules/@noodle-borg/runtime/dist/invocation-context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=invocation-context.js.map

package/node_modules/@noodle-borg/runtime/dist/invocation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-context.js","sourceRoot":"","sources":["../src/invocation-context.ts"],"names":[],"mappings":""}

package/node_modules/@noodle-borg/runtime/dist/result.d.ts

@@ -1,6 +1,5 @@
-/** Why a tool call could not be fulfilled. Internal contract — the protocol adapter maps these to
- * the MCP wire shape in a later slice. */
-export type ExecutionErrorCode = 'shape_only_artifact' | 'unknown_tool' | 'unknown_resource' | 'unknown_prompt' | 'unsupported_fulfilment' | 'connector_unavailable' | 'credential_unavailable' | 'signature_drift' | 'policy_denied' | 'policy_error' | 'arg_invalid' | 'expression_error' | 'circular_call_dependency' | 'connector_error' | 'output_invalid';
+/** Why a tool call could not be fulfilled. Protocol and embedded adapters map this internal contract. */
+export type ExecutionErrorCode = 'shape_only_artifact' | 'unknown_tool' | 'unknown_resource' | 'unknown_prompt' | 'unsupported_fulfilment' | 'connector_unavailable' | 'credential_unavailable' | 'signature_drift' | 'policy_denied' | 'policy_error' | 'arg_invalid' | 'invalid_continuation' | 'invalid_elicitation_flow' | 'invalid_confirmation_flow' | 'expression_error' | 'circular_call_dependency' | 'connector_error' | 'output_invalid';
 /** A typed execution failure. `path` locates the offending field/expression when applicable and
  * never carries a sensitive value. */
 export interface ExecutionError {
@@ -16,4 +15,137 @@ export type ExecutionResult = {
     readonly ok: false;
     readonly error: ExecutionError;
 };
+/** Portable form input requested by an `elicit` flow step. Safe to expose to a host/client. */
+export interface ElicitationRequest {
+    readonly id: string;
+    readonly message: string;
+    readonly requestedSchema: Readonly<Record<string, unknown>>;
+}
+export type ElicitationResponse = {
+    readonly action: 'accept';
+    readonly content?: unknown;
+} | {
+    readonly action: 'decline' | 'cancel';
+};
+/**
+ * Server-side continuation state. Adapters persist this behind an opaque interaction id; it must
+ * never be serialized into MCP or embedded-assistant client payloads.
+ */
+export interface ToolContinuation {
+    readonly version: 1;
+    readonly artifact: {
+        readonly manifestName: string;
+        readonly manifestVersion: string;
+        readonly serverName: string;
+        readonly serverVersion: string;
+    };
+    readonly toolName: string;
+    readonly input: unknown;
+    readonly nextStepIndex: number;
+    readonly completedSteps: Readonly<Record<string, unknown>>;
+    readonly resultMetas: readonly Readonly<Record<string, unknown>>[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly pending: ElicitationRequest;
+}
+interface ContinuationArtifactIdentity {
+    readonly manifestName: string;
+    readonly manifestVersion: string;
+    readonly serverName: string;
+    readonly serverVersion: string;
+}
+/**
+ * Server-side state while a confirmable tool is collecting its elicited prefix. This continuation
+ * can evaluate pure maps and request more input, but cannot execute a connector operation.
+ */
+export interface ToolPreparationContinuation {
+    readonly kind: 'confirmation_preparation';
+    readonly version: 1;
+    readonly artifact: ContinuationArtifactIdentity;
+    readonly toolName: string;
+    readonly input: unknown;
+    readonly nextStepIndex: number;
+    readonly completedSteps: Readonly<Record<string, unknown>>;
+    readonly elicited: Readonly<Record<string, unknown>>;
+    readonly env: Readonly<Record<string, string>>;
+    readonly pending: ElicitationRequest;
+}
+/**
+ * Server-side state after all pre-confirmation input has been collected. Adapters persist this
+ * behind an opaque interaction id and release it to {@code executePreparedTool} only after approval.
+ */
+export interface PreparedToolContinuation {
+    readonly kind: 'prepared_confirmation';
+    readonly version: 1;
+    readonly artifact: ContinuationArtifactIdentity;
+    readonly toolName: string;
+    readonly input: unknown;
+    /** First flow step not evaluated during preparation; zero for a single-operation fulfilment. */
+    readonly nextStepIndex: number;
+    readonly completedSteps: Readonly<Record<string, unknown>>;
+    readonly env: Readonly<Record<string, string>>;
+    /** Exact first connector invocation approved by the user; absent for a pure flow. */
+    readonly reviewedAction?: PreparedOperationAction;
+}
+/** Exact connector invocation bound into a prepared confirmation continuation. */
+export interface PreparedOperationAction {
+    readonly connectorId: string;
+    readonly connectorVersion: string;
+    readonly operation: string;
+    readonly arguments: Readonly<Record<string, unknown>>;
+}
+/** Server-side data from which an adapter can construct a safely redacted action review. */
+export interface ConfirmationActionReview extends PreparedOperationAction {
+    readonly inputSchema: Readonly<Record<string, unknown>>;
+    /** Later connector calls may depend on this action's output and are disclosed, not pre-resolved. */
+    readonly additionalOperationCount: number;
+}
+/**
+ * Values an adapter may summarize in its confirmation UI. This is server-side presentation input,
+ * not a wire-safe payload: the adapter must redact the original input against the tool schema.
+ */
+export interface ConfirmationReview {
+    readonly input: unknown;
+    readonly elicited: Readonly<Record<string, unknown>>;
+    /** Exact first connector invocation after all pure maps, ambient facts, and elicited values. */
+    readonly action?: ConfirmationActionReview;
+}
+export type ConfirmationPreparationResult = {
+    readonly status: 'input_required';
+    readonly request: ElicitationRequest;
+    readonly continuation: ToolPreparationContinuation;
+} | {
+    readonly status: 'confirmation_required';
+    readonly review: ConfirmationReview;
+    readonly continuation: PreparedToolContinuation;
+} | {
+    readonly status: 'stopped';
+    readonly action: 'decline' | 'cancel';
+} | {
+    readonly status: 'failed';
+    readonly error: ExecutionError;
+};
+export type InteractiveExecutionResult = {
+    readonly status: 'completed';
+    readonly output: unknown;
+} | {
+    readonly status: 'input_required';
+    readonly request: ElicitationRequest;
+    readonly continuation: ToolContinuation;
+} | {
+    readonly status: 'stopped';
+    readonly action: 'decline' | 'cancel';
+} | {
+    readonly status: 'failed';
+    readonly error: ExecutionError;
+};
+export declare function isInputRequired(result: InteractiveExecutionResult): result is Extract<InteractiveExecutionResult, {
+    readonly status: 'input_required';
+}>;
+export declare function isInputRequiredForConfirmation(result: ConfirmationPreparationResult): result is Extract<ConfirmationPreparationResult, {
+    readonly status: 'input_required';
+}>;
+export declare function isConfirmationRequired(result: ConfirmationPreparationResult): result is Extract<ConfirmationPreparationResult, {
+    readonly status: 'confirmation_required';
+}>;
+export {};
 //# sourceMappingURL=result.d.ts.map

package/node_modules/@noodle-borg/runtime/dist/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;0CAC0C;AAC1C,MAAM,MAAM,kBAAkB,GAC1B,qBAAqB,GACrB,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,wBAAwB,GACxB,uBAAuB,GACvB,wBAAwB,GACxB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,0BAA0B,GAC1B,iBAAiB,GACjB,gBAAgB,CAAC;AAErB;sCACsC;AACtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mFAAmF;AACnF,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"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"}

package/node_modules/@noodle-borg/runtime/dist/result.js

@@ -1,2 +1,10 @@
-export {};
+export function isInputRequired(result) {
+    return result.status === 'input_required';
+}
+export function isInputRequiredForConfirmation(result) {
+    return result.status === 'input_required';
+}
+export function isConfirmationRequired(result) {
+    return result.status === 'confirmation_required';
+}
 //# sourceMappingURL=result.js.map

package/node_modules/@noodle-borg/runtime/dist/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":""}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AA8JA,MAAM,UAAU,eAAe,CAC7B,MAAkC;IAElC,OAAO,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAAqC;IAErC,OAAO,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAqC;IAErC,OAAO,MAAM,CAAC,MAAM,KAAK,uBAAuB,CAAC;AACnD,CAAC"}

package/node_modules/@noodle-borg/service/dist/assistant-context.d.ts

@@ -0,0 +1,25 @@
+import type { InvocationContext } from '@noodle-borg/runtime';
+export interface AssistantContextPreferences {
+    readonly locale?: string | undefined;
+    readonly timeZone?: string | undefined;
+}
+interface ResolveInvocationContextInput {
+    readonly instant: Date;
+    readonly applicationPreference?: AssistantContextPreferences;
+    readonly clientHint?: AssistantContextPreferences;
+    readonly defaults?: AssistantContextPreferences;
+}
+export type AssistantContextPreferencesResult = {
+    readonly ok: true;
+    readonly value: AssistantContextPreferences;
+} | {
+    readonly ok: false;
+};
+/** Resolve presentation preferences independently from server-authoritative time. */
+export declare function resolveInvocationContext(input: ResolveInvocationContextInput): InvocationContext;
+/** Stable temporal grounding line shared by normal turns and interaction continuations. */
+export declare function invocationContextSystemMessage(context: InvocationContext): string;
+/** Validate and canonicalize a backend-supplied preference object at the session boundary. */
+export declare function parseAssistantContextPreferences(value: unknown): AssistantContextPreferencesResult;
+export {};
+//# sourceMappingURL=assistant-context.d.ts.map

package/node_modules/@noodle-borg/service/dist/assistant-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-context.d.ts","sourceRoot":"","sources":["../src/assistant-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAqC,MAAM,sBAAsB,CAAC;AAEjG,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,UAAU,6BAA6B;IACrC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,2BAA2B,CAAC;CACjD;AAED,MAAM,MAAM,iCAAiC,GACzC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAI3B,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,iBAAiB,CAuBhG;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAOjF;AAED,8FAA8F;AAC9F,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,GACb,iCAAiC,CAoBnC"}

package/node_modules/@noodle-borg/service/dist/assistant-context.js

@@ -0,0 +1,130 @@
+const PLATFORM_DEFAULTS = { locale: 'en-US', timeZone: 'UTC' };
+/** Resolve presentation preferences independently from server-authoritative time. */
+export function resolveInvocationContext(input) {
+    if (!Number.isFinite(input.instant.getTime()))
+        throw new RangeError('invalid invocation instant');
+    const locale = resolvePreference(input, 'locale', canonicalLocale, PLATFORM_DEFAULTS.locale);
+    const timeZone = resolvePreference(input, 'timeZone', canonicalTimeZone, PLATFORM_DEFAULTS.timeZone);
+    const parts = localParts(input.instant, timeZone.value);
+    return {
+        temporal: {
+            instant: input.instant.toISOString(),
+            localDate: `${parts.year}-${parts.month}-${parts.day}`,
+            localTime: `${parts.hour}:${parts.minute}:${parts.second}`,
+            utcOffset: offsetFromPart(parts.timeZoneName),
+            weekday: parts.weekday,
+            timeZone: timeZone.value,
+            locale: locale.value,
+            source: { locale: locale.source, timeZone: timeZone.source },
+        },
+        ambientStatus: 'not_configured',
+    };
+}
+/** Stable temporal grounding line shared by normal turns and interaction continuations. */
+export function invocationContextSystemMessage(context) {
+    const temporal = context.temporal;
+    return (`Current server time: ${temporal.instant}. User-local date and time: ` +
+        `${temporal.localDate} ${temporal.localTime} ${temporal.utcOffset} ` +
+        `(${temporal.weekday}, ${temporal.timeZone}; locale ${temporal.locale}).`);
+}
+/** Validate and canonicalize a backend-supplied preference object at the session boundary. */
+export function parseAssistantContextPreferences(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return { ok: false };
+    const record = value;
+    if (Object.keys(record).some((key) => key !== 'locale' && key !== 'timeZone')) {
+        return { ok: false };
+    }
+    const result = {};
+    if (record.locale !== undefined) {
+        if (typeof record.locale !== 'string' || record.locale.length > 160)
+            return { ok: false };
+        const locale = canonicalLocale(record.locale);
+        if (locale === undefined)
+            return { ok: false };
+        result.locale = locale;
+    }
+    if (record.timeZone !== undefined) {
+        if (typeof record.timeZone !== 'string' || record.timeZone.length > 160)
+            return { ok: false };
+        const timeZone = canonicalTimeZone(record.timeZone);
+        if (timeZone === undefined)
+            return { ok: false };
+        result.timeZone = timeZone;
+    }
+    return { ok: true, value: result };
+}
+function resolvePreference(input, field, canonicalize, platformDefault) {
+    const candidates = [
+        { value: input.applicationPreference?.[field], source: 'user-preference' },
+        { value: input.clientHint?.[field], source: 'client-hint' },
+        { value: input.defaults?.[field], source: 'server-default' },
+        { value: platformDefault, source: 'platform-default' },
+    ];
+    for (const candidate of candidates) {
+        if (candidate.value === undefined)
+            continue;
+        const canonical = canonicalize(candidate.value);
+        if (canonical !== undefined)
+            return { value: canonical, source: candidate.source };
+    }
+    // The platform defaults are compile-time constants validated by the same canonicalizers.
+    throw new Error(`invalid platform ${field} default`);
+}
+function canonicalLocale(value) {
+    try {
+        return Intl.getCanonicalLocales(value.trim())[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+function canonicalTimeZone(value) {
+    try {
+        return new Intl.DateTimeFormat('en-US', { timeZone: value.trim() }).resolvedOptions().timeZone;
+    }
+    catch {
+        return undefined;
+    }
+}
+function localParts(instant, timeZone) {
+    const formatter = new Intl.DateTimeFormat('en-US-u-ca-iso8601-nu-latn', {
+        timeZone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        weekday: 'long',
+        timeZoneName: 'longOffset',
+        hourCycle: 'h23',
+    });
+    const parts = Object.fromEntries(formatter
+        .formatToParts(instant)
+        .filter((part) => part.type !== 'literal')
+        .map((part) => [part.type, part.value]));
+    const required = [
+        'year',
+        'month',
+        'day',
+        'hour',
+        'minute',
+        'second',
+        'weekday',
+        'timeZoneName',
+    ];
+    if (required.some((key) => parts[key] === undefined)) {
+        throw new RangeError('unable to resolve local date and time');
+    }
+    return parts;
+}
+function offsetFromPart(value) {
+    if (value === 'GMT' || value === 'UTC')
+        return '+00:00';
+    const match = /^GMT([+-]\d{2}:\d{2})$/.exec(value ?? '');
+    if (!match?.[1])
+        throw new RangeError(`unsupported timezone offset ${value ?? 'unknown'}`);
+    return match[1];
+}
+//# sourceMappingURL=assistant-context.js.map

package/node_modules/@noodle-borg/service/dist/assistant-context.js.map

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

package/node_modules/@noodle-borg/service/dist/assistant-interaction-state.d.ts

@@ -0,0 +1,181 @@
+import type { InvocationContext } from '@noodle-borg/runtime';
+export declare const DEFAULT_MAX_PENDING_INTERACTIONS_PER_SESSION = 8;
+export declare const ASSISTANT_INTERACTION_OUTCOME_RETENTION_MS: number;
+/** Recovery grace for an in-flight action before its outcome becomes unknowable and payload is scrubbed. */
+export declare const ASSISTANT_INTERACTION_EXECUTING_GRACE_MS: number;
+export type AssistantInteractionKind = 'confirmation' | 'input';
+export type AssistantInteractionStatus = 'pending' | 'executing' | 'succeeded' | 'failed' | 'declined' | 'cancelled';
+export type AssistantInteractionPublicScalar = string | number | boolean | null;
+export interface AssistantInteractionPublicArray extends ReadonlyArray<AssistantInteractionPublicValue> {
+    readonly [index: number]: AssistantInteractionPublicValue;
+}
+export interface AssistantInteractionPublicObject {
+    readonly [key: string]: AssistantInteractionPublicValue;
+}
+export type AssistantInteractionPublicValue = AssistantInteractionPublicScalar | AssistantInteractionPublicArray | AssistantInteractionPublicObject;
+/** Compact replay-safe data only. Exact connector output and errors must never enter this shape. */
+export interface AssistantInteractionPublicOutcome {
+    readonly code: string;
+    readonly summary: string;
+    readonly details?: Readonly<Record<string, AssistantInteractionPublicScalar>>;
+    readonly result?: AssistantInteractionPublicValue;
+}
+export declare const ASSISTANT_INTERACTION_UNKNOWN_OUTCOME: AssistantInteractionPublicOutcome;
+interface AssistantInteractionCommon {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly deploymentId: string;
+    /** Immutable proposal-time snapshot reused when the interaction resumes. */
+    readonly context?: InvocationContext;
+    /** Set when a terminal interaction's exact private payload has been removed. */
+    readonly payloadScrubbedAt?: string;
+    readonly createdAt: string;
+    readonly expiresAt: string;
+}
+interface AssistantConfirmationInteractionPayload {
+    readonly kind: 'confirmation';
+    readonly tool: string;
+    /** Exact validated arguments. Store-internal; renderers receive a separate review projection. */
+    readonly arguments: unknown;
+    /** Prepared post-elicitation execution state. Server-internal and absent on legacy proposals. */
+    readonly continuation?: unknown;
+    /** Complete, already-redacted review projection retained so a lost response can be replayed. */
+    readonly review?: unknown;
+}
+interface AssistantInputInteractionPayload {
+    readonly kind: 'input';
+    readonly tool: string;
+    readonly message: string;
+    readonly requestedSchema: Readonly<Record<string, unknown>>;
+    /** Exact runtime continuation. Store-internal and never part of the public interaction event. */
+    readonly continuation: unknown;
+}
+export interface AssistantPendingInteractionState {
+    readonly status: 'pending';
+}
+export interface AssistantExecutingInteractionState {
+    readonly status: 'executing';
+    readonly claimedAt: string;
+}
+export interface AssistantSucceededInteractionState {
+    readonly status: 'succeeded';
+    readonly claimedAt: string;
+    readonly completedAt: string;
+    readonly publicOutcome: AssistantInteractionPublicOutcome;
+}
+export interface AssistantFailedInteractionState {
+    readonly status: 'failed';
+    readonly claimedAt: string;
+    readonly completedAt: string;
+    readonly publicOutcome: AssistantInteractionPublicOutcome;
+}
+export interface AssistantDeclinedInteractionState {
+    readonly status: 'declined';
+    readonly completedAt: string;
+    readonly publicOutcome: AssistantInteractionPublicOutcome;
+}
+export interface AssistantCancelledInteractionState {
+    readonly status: 'cancelled';
+    readonly completedAt: string;
+    readonly publicOutcome: AssistantInteractionPublicOutcome;
+}
+export type AssistantInteractionState = AssistantPendingInteractionState | AssistantExecutingInteractionState | AssistantSucceededInteractionState | AssistantFailedInteractionState | AssistantDeclinedInteractionState | AssistantCancelledInteractionState;
+export type AssistantTerminalInteractionState = AssistantSucceededInteractionState | AssistantFailedInteractionState | AssistantDeclinedInteractionState | AssistantCancelledInteractionState;
+export type AssistantConfirmationInteractionRecord = AssistantInteractionCommon & AssistantConfirmationInteractionPayload & AssistantInteractionState;
+export type AssistantInputInteractionRecord = AssistantInteractionCommon & AssistantInputInteractionPayload & AssistantInteractionState;
+export type AssistantInteractionRecord = AssistantConfirmationInteractionRecord | AssistantInputInteractionRecord;
+export type AssistantPendingConfirmationInteractionRecord = AssistantInteractionCommon & AssistantConfirmationInteractionPayload & AssistantPendingInteractionState;
+export type AssistantPendingInputInteractionRecord = AssistantInteractionCommon & AssistantInputInteractionPayload & AssistantPendingInteractionState;
+export type AssistantPendingInteractionRecord = AssistantPendingConfirmationInteractionRecord | AssistantPendingInputInteractionRecord;
+interface AssistantInteractionCreateCommon {
+    readonly sessionId: string;
+    readonly deploymentId: string;
+    readonly context?: InvocationContext;
+    /** Omit only when the persistence adapter should stamp its own proposal time. */
+    readonly createdAt?: string;
+    readonly expiresAt: string;
+}
+export type AssistantConfirmationInteractionCreateInput = AssistantInteractionCreateCommon & Omit<AssistantConfirmationInteractionPayload, never>;
+export type AssistantInputInteractionCreateInput = AssistantInteractionCreateCommon & Omit<AssistantInputInteractionPayload, never>;
+export type AssistantInteractionCreateInput = AssistantConfirmationInteractionCreateInput | AssistantInputInteractionCreateInput;
+export interface AssistantInteractionScope {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly deploymentId: string;
+    readonly now: Date;
+}
+export type AssistantInteractionClaimResult = {
+    readonly disposition: 'claimed';
+    readonly interaction: AssistantInteractionRecord & AssistantExecutingInteractionState;
+} | {
+    readonly disposition: 'replay';
+    readonly interaction: AssistantInteractionRecord;
+} | {
+    readonly disposition: 'unavailable';
+};
+export type AssistantInteractionCompletion = {
+    readonly status: 'succeeded' | 'failed';
+    readonly publicOutcome: AssistantInteractionPublicOutcome;
+} | {
+    readonly status: 'declined' | 'cancelled';
+    readonly publicOutcome?: AssistantInteractionPublicOutcome;
+};
+export type AssistantInteractionCompletionResult = {
+    readonly disposition: 'completed';
+    readonly interaction: AssistantInteractionRecord;
+} | {
+    readonly disposition: 'replay';
+    readonly interaction: AssistantInteractionRecord;
+} | {
+    readonly disposition: 'conflict';
+    readonly interaction: AssistantInteractionRecord;
+} | {
+    readonly disposition: 'unavailable';
+};
+export type AssistantInteractionTransitionNext = Omit<AssistantConfirmationInteractionCreateInput, 'sessionId' | 'deploymentId' | 'createdAt'> | Omit<AssistantInputInteractionCreateInput, 'sessionId' | 'deploymentId' | 'createdAt'>;
+/**
+ * Atomically records that an executing interaction handed control to one new pending interaction.
+ * The store owns the child identity and persists it in the parent's replay-safe public outcome.
+ */
+export interface AssistantInteractionTransitionInput extends AssistantInteractionScope {
+    readonly publicOutcome: AssistantInteractionPublicOutcome;
+    readonly next: AssistantInteractionTransitionNext;
+}
+export type AssistantInteractionTransitionResult = {
+    readonly disposition: 'transitioned';
+    readonly interaction: AssistantInteractionRecord & AssistantSucceededInteractionState;
+    readonly next: AssistantPendingInteractionRecord;
+} | {
+    readonly disposition: 'replay';
+    readonly interaction: AssistantInteractionRecord;
+} | {
+    readonly disposition: 'conflict';
+    readonly interaction: AssistantInteractionRecord;
+} | {
+    readonly disposition: 'unavailable';
+};
+export declare class AssistantInteractionCapacityError extends Error {
+    readonly code: "pending_interaction_limit";
+    constructor();
+}
+export declare function createPendingInteraction(id: string, input: AssistantConfirmationInteractionCreateInput): AssistantPendingConfirmationInteractionRecord;
+export declare function createPendingInteraction(id: string, input: AssistantInputInteractionCreateInput): AssistantPendingInputInteractionRecord;
+export declare function executingInteraction(interaction: AssistantInteractionRecord, claimedAt: Date): AssistantInteractionRecord & AssistantExecutingInteractionState;
+export declare function completedInteraction(interaction: AssistantInteractionRecord, completion: AssistantInteractionCompletion, completedAt: Date): AssistantInteractionRecord & AssistantTerminalInteractionState;
+export declare function transitionedInteractions(interaction: AssistantInteractionRecord, input: AssistantInteractionTransitionInput, nextId: string): {
+    readonly interaction: AssistantInteractionRecord & AssistantSucceededInteractionState;
+    readonly next: AssistantPendingInteractionRecord;
+};
+export declare function isTerminalInteraction(interaction: AssistantInteractionRecord): interaction is AssistantInteractionRecord & AssistantTerminalInteractionState;
+/**
+ * Pending proposals expire at their decision deadline. Executing/unknown work keeps a tombstone, and a
+ * terminal public outcome remains replayable for a bounded reconciliation window after completion.
+ */
+export declare function isPrunableInteraction(interaction: AssistantInteractionRecord, now: Date): boolean;
+export declare function shouldExpireStrandedExecutingInteraction(interaction: AssistantInteractionRecord, now: Date): interaction is AssistantInteractionRecord & AssistantExecutingInteractionState;
+/** Preserve a non-retryable unknown outcome without retaining its exact private payload. */
+export declare function expireStrandedExecutingInteraction(interaction: AssistantInteractionRecord & AssistantExecutingInteractionState, scrubbedAt: Date): AssistantInteractionRecord & AssistantFailedInteractionState;
+export declare function cloneInteraction<T extends AssistantInteractionRecord>(interaction: T): T;
+export declare function normalizePublicOutcome(input: AssistantInteractionPublicOutcome): AssistantInteractionPublicOutcome;
+export {};
+//# sourceMappingURL=assistant-interaction-state.d.ts.map

package/node_modules/@noodle-borg/service/dist/assistant-interaction-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-interaction-state.d.ts","sourceRoot":"","sources":["../src/assistant-interaction-state.ts"],"names":[],"mappings":"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"}