@ekairos/events 1.22.35-beta.development.0 → 1.22.35

package/dist/context.runtime.d.ts

@@ -1,11 +1,21 @@
-import type { ConcreteDomain } from "@ekairos/domain";
-import type { ExplicitRuntimeLike } from "@ekairos/domain/runtime";
+import type { ConcreteDomain, DomainLike } from "@ekairos/domain";
+import type { EkairosRuntime, RuntimeForDomain, RuntimeResolveOptions } from "@ekairos/domain/runtime";
 import type { ContextEnvironment } from "./context.config.js";
 import type { ContextStore } from "./context.store.js";
-export type ContextRuntime<Env extends ContextEnvironment = ContextEnvironment> = ExplicitRuntimeLike<Env, any, any>;
+import { eventsDomain } from "./schema.js";
+export type ContextRuntime<Env extends ContextEnvironment = ContextEnvironment> = EkairosRuntime<Env, any, any>;
+export type ContextRuntimeServiceHandle = {
+    db: any | ((...args: any[]) => Promise<any> | any);
+    resolve?: (...args: any[]) => Promise<any> | any;
+    meta?: (...args: any[]) => Record<string, unknown> | undefined;
+};
+export type ContextRuntimeHandleForDomain<Env extends ContextEnvironment = ContextEnvironment, RequiredDomain extends DomainLike = typeof eventsDomain> = ContextRuntimeServiceHandle & {
+    use<Subdomain extends typeof eventsDomain | RequiredDomain>(subdomain: Subdomain, options?: RuntimeResolveOptions): Promise<unknown>;
+};
+export type ContextRuntimeForDomain<Runtime extends ContextRuntime<any>, RequiredDomain extends DomainLike = typeof eventsDomain> = RuntimeForDomain<Runtime, typeof eventsDomain> & RuntimeForDomain<Runtime, RequiredDomain>;
 export type ContextRuntimeServices = {
     db: any;
     store: ContextStore;
     domain?: ConcreteDomain<any, any>;
 };
-export declare function getContextRuntimeServices(runtime: ContextRuntime<any>): Promise<ContextRuntimeServices>;
+export declare function getContextRuntimeServices(runtime: ContextRuntimeServiceHandle): Promise<ContextRuntimeServices>;

package/dist/context.runtime.js

@@ -1,6 +1,13 @@
 const storeByDb = new WeakMap();
+function asRecord(value) {
+    return value && typeof value === "object" ? value : {};
+}
 export async function getContextRuntimeServices(runtime) {
-    const db = await runtime.db();
+    const runtimeRecord = asRecord(runtime);
+    const dbMember = runtimeRecord.db;
+    const db = typeof dbMember === "function"
+        ? await dbMember.call(runtime)
+        : dbMember;
     if (!db) {
         throw new Error("Context runtime did not provide a database instance.");
     }
@@ -12,10 +19,21 @@ export async function getContextRuntimeServices(runtime) {
             storeByDb.set(db, store);
         }
     }
-    const resolved = await runtime.resolve();
+    const resolveMember = runtimeRecord.resolve;
+    const resolved = typeof resolveMember === "function"
+        ? await resolveMember.call(runtime)
+        : runtime;
+    const resolvedMeta = asRecord(resolved).meta;
+    const ownMeta = runtimeRecord.meta;
+    const meta = typeof resolvedMeta === "function"
+        ? resolvedMeta.call(resolved)
+        : typeof ownMeta === "function"
+            ? ownMeta.call(runtime)
+            : undefined;
+    const domain = asRecord(meta).domain;
     return {
         db,
         store,
-        domain: typeof resolved === "object" && resolved !== null ? resolved.meta?.()?.domain : undefined,
+        domain: domain,
     };
 }

package/dist/context.step-stream.d.ts

@@ -5,22 +5,36 @@ export type ContextStepStreamChunk = {
     at: string;
     sequence: number;
     chunkType: ContextStreamChunkType;
+    partId?: string;
+    providerPartId?: string;
+    partType?: string;
+    partSlot?: string;
     provider?: string;
     providerChunkType?: string;
     actionRef?: string;
     data?: unknown;
     raw?: unknown;
 };
+export type ContextStepStreamChunkValidationOptions = {
+    stepId?: string;
+    label?: string;
+};
 export declare function createContextStepStreamChunk(params: {
     at?: string;
     sequence: number;
     chunkType: ContextStreamChunkType;
+    stepId?: string;
+    partId?: string;
+    providerPartId?: string;
+    partType?: string;
+    partSlot?: string;
     provider?: string;
     providerChunkType?: string;
     actionRef?: string;
     data?: unknown;
     raw?: unknown;
 }): ContextStepStreamChunk;
-export declare function parseContextStepStreamChunk(value: string | unknown): ContextStepStreamChunk;
-export declare function encodeContextStepStreamChunk(chunk: ContextStepStreamChunk): string;
+export declare function validateContextStepStreamChunk(value: unknown, options?: ContextStepStreamChunkValidationOptions): asserts value is ContextStepStreamChunk;
+export declare function parseContextStepStreamChunk(value: string | unknown, options?: ContextStepStreamChunkValidationOptions): ContextStepStreamChunk;
+export declare function encodeContextStepStreamChunk(chunk: ContextStepStreamChunk, options?: ContextStepStreamChunkValidationOptions): string;
 export declare function contextStreamByteLength(value: string): number;

package/dist/context.step-stream.js

@@ -1,4 +1,5 @@
 import { isContextStreamChunkType, } from "./context.contract.js";
+import { assertValidContextPartChunkIdentity } from "./context.part-identity.js";
 export const CONTEXT_STEP_STREAM_VERSION = 1;
 function assertObject(value, label) {
     if (!value || typeof value !== "object") {
@@ -15,43 +16,84 @@ function assertNumber(value, label) {
         throw new Error(`Invalid ${label}: expected number.`);
     }
 }
+function assertPositiveInteger(value, label) {
+    assertNumber(value, label);
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error(`Invalid ${label}: expected positive integer.`);
+    }
+}
+function assertIsoDateString(value, label) {
+    assertString(value, label);
+    if (Number.isNaN(Date.parse(value))) {
+        throw new Error(`Invalid ${label}: expected ISO date string.`);
+    }
+}
 function assertOptionalString(value, label) {
     if (typeof value === "undefined")
         return;
     assertString(value, label);
 }
 export function createContextStepStreamChunk(params) {
-    return {
+    const chunk = {
         version: CONTEXT_STEP_STREAM_VERSION,
         at: params.at ?? new Date().toISOString(),
         sequence: params.sequence,
         chunkType: params.chunkType,
+        partId: params.partId,
+        providerPartId: params.providerPartId,
+        partType: params.partType,
+        partSlot: params.partSlot,
         provider: params.provider,
         providerChunkType: params.providerChunkType,
         actionRef: params.actionRef,
         data: params.data,
         raw: params.raw,
     };
+    validateContextStepStreamChunk(chunk, {
+        stepId: params.stepId,
+        label: "context step stream chunk",
+    });
+    return chunk;
 }
-export function parseContextStepStreamChunk(value) {
-    const parsed = typeof value === "string" ? JSON.parse(value) : value;
-    assertObject(parsed, "context step stream chunk");
-    assertNumber(parsed.version, "context step stream chunk.version");
-    if (parsed.version !== CONTEXT_STEP_STREAM_VERSION) {
-        throw new Error(`Unsupported context step stream chunk version: ${String(parsed.version)}`);
+export function validateContextStepStreamChunk(value, options = {}) {
+    const label = options.label ?? "context step stream chunk";
+    assertObject(value, label);
+    assertNumber(value.version, `${label}.version`);
+    if (value.version !== CONTEXT_STEP_STREAM_VERSION) {
+        throw new Error(`Unsupported ${label}.version: ${String(value.version)}`);
     }
-    assertString(parsed.at, "context step stream chunk.at");
-    assertNumber(parsed.sequence, "context step stream chunk.sequence");
-    assertString(parsed.chunkType, "context step stream chunk.chunkType");
-    if (!isContextStreamChunkType(parsed.chunkType)) {
-        throw new Error(`Invalid context step stream chunk.chunkType: ${String(parsed.chunkType)}`);
+    assertIsoDateString(value.at, `${label}.at`);
+    assertPositiveInteger(value.sequence, `${label}.sequence`);
+    assertString(value.chunkType, `${label}.chunkType`);
+    if (!isContextStreamChunkType(value.chunkType)) {
+        throw new Error(`Invalid ${label}.chunkType: ${String(value.chunkType)}`);
     }
-    assertOptionalString(parsed.provider, "context step stream chunk.provider");
-    assertOptionalString(parsed.providerChunkType, "context step stream chunk.providerChunkType");
-    assertOptionalString(parsed.actionRef, "context step stream chunk.actionRef");
+    assertOptionalString(value.partId, `${label}.partId`);
+    assertOptionalString(value.providerPartId, `${label}.providerPartId`);
+    assertOptionalString(value.partType, `${label}.partType`);
+    assertOptionalString(value.partSlot, `${label}.partSlot`);
+    assertOptionalString(value.provider, `${label}.provider`);
+    assertOptionalString(value.providerChunkType, `${label}.providerChunkType`);
+    assertOptionalString(value.actionRef, `${label}.actionRef`);
+    assertValidContextPartChunkIdentity({
+        label,
+        stepId: options.stepId,
+        chunkType: value.chunkType,
+        partId: value.partId,
+        provider: value.provider,
+        providerPartId: value.providerPartId,
+        partType: value.partType,
+        partSlot: value.partSlot,
+        actionRef: value.actionRef,
+    });
+}
+export function parseContextStepStreamChunk(value, options = {}) {
+    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+    validateContextStepStreamChunk(parsed, options);
     return parsed;
 }
-export function encodeContextStepStreamChunk(chunk) {
+export function encodeContextStepStreamChunk(chunk, options = {}) {
+    validateContextStepStreamChunk(chunk, options);
     return `${JSON.stringify(chunk)}\n`;
 }
 export function contextStreamByteLength(value) {

package/dist/context.store.d.ts

@@ -1,5 +1,5 @@
 import type { ModelMessage } from "ai";
-import type { ContextStatus, ExecutionStatus, StepStatus, StepKind, ItemStatus, ItemType, Channel } from "./context.contract.js";
+import type { ContextStatus, ExecutionStatus, StepStatus, ItemStatus, ItemType, Channel } from "./context.contract.js";
 export type ContextIdentifier = {
     id: string;
     key?: never;
@@ -8,6 +8,50 @@ export type ContextIdentifier = {
     id?: never;
 };
 export type { ContextStatus } from "./context.contract.js";
+export type ContextResourceBase = {
+    key: string;
+    type: string;
+    name: string;
+    description: string;
+    role?: string | null;
+    metadata?: Record<string, unknown> | null;
+};
+export type ContextFileResource = ContextResourceBase & {
+    type: "file";
+    fileId?: string;
+    documentId?: string;
+    url?: string;
+    filename?: string;
+    mediaType?: string;
+    size?: number;
+};
+export type ContextLinkResource = ContextResourceBase & {
+    type: "link";
+    url: string;
+};
+export type ContextRepositoryResource = ContextResourceBase & {
+    type: "repository";
+    provider?: string;
+    repository: string;
+    ref?: string;
+    paths?: string[];
+    commitSha?: string;
+};
+export type ContextDatasetResource = ContextResourceBase & {
+    type: "dataset";
+    datasetId: string;
+};
+export type ContextExternalResource = ContextResourceBase & {
+    type: "external";
+    uri?: string;
+};
+export type ContextResource = ContextFileResource | ContextLinkResource | ContextRepositoryResource | ContextDatasetResource | ContextExternalResource | (ContextResourceBase & Record<string, unknown>);
+export type StoredContextResource = ContextResource & {
+    id?: string;
+    storageKey?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+};
 export type StoredContext<Context> = {
     id: string;
     key: string | null;
@@ -16,6 +60,9 @@ export type StoredContext<Context> = {
     createdAt: Date;
     updatedAt?: Date;
     content: Context | null;
+    description?: string | null;
+    goal?: string | null;
+    resources?: StoredContextResource[] | null;
     reactor?: {
         kind: string;
         state?: Record<string, unknown> | null;
@@ -43,14 +90,6 @@ export type ContextStep = {
     updatedAt?: Date;
     status: StepStatus;
     iteration: number;
-    kind?: StepKind;
-    actionName?: string;
-    actionInput?: unknown;
-    actionOutput?: unknown;
-    actionError?: string;
-    actionRequests?: any;
-    actionResults?: any;
-    continueLoop?: boolean;
     errorText?: string;
 };
 export type ContextExecution = {
@@ -61,6 +100,12 @@ export interface ContextStore {
     getOrCreateContext<C>(contextIdentifier: ContextIdentifier | null): Promise<StoredContext<C>>;
     getContext<C>(contextIdentifier: ContextIdentifier): Promise<StoredContext<C> | null>;
     updateContextContent<C>(contextIdentifier: ContextIdentifier, content: C): Promise<StoredContext<C>>;
+    updateContextDefinition<C>(contextIdentifier: ContextIdentifier, definition: {
+        description?: string | null;
+        goal?: string | null;
+    }): Promise<StoredContext<C>>;
+    upsertContextResources(contextIdentifier: ContextIdentifier, resources: ContextResource[]): Promise<StoredContextResource[]>;
+    getContextResources(contextIdentifier: ContextIdentifier): Promise<StoredContextResource[]>;
     updateContextReactor<C>(contextIdentifier: ContextIdentifier, reactor: {
         kind: string;
         state?: Record<string, unknown> | null;
@@ -80,7 +125,7 @@ export interface ContextStore {
     }): Promise<{
         id: string;
     }>;
-    updateStep(stepId: string, patch: Partial<Pick<ContextStep, "status" | "kind" | "actionName" | "actionInput" | "actionOutput" | "actionError" | "actionRequests" | "actionResults" | "continueLoop" | "errorText" | "updatedAt">>): Promise<void>;
+    updateStep(stepId: string, patch: Partial<Pick<ContextStep, "status" | "errorText" | "updatedAt">>): Promise<void>;
     saveStepParts(params: {
         stepId: string;
         parts: any[];

package/dist/context.stream.d.ts

@@ -1,4 +1,4 @@
-import type { ContextStatus, ExecutionStatus, ItemStatus, ItemType, StepKind, StepStatus, ContextStreamChunkType } from "./context.contract.js";
+import type { ContextStatus, ExecutionStatus, ItemStatus, ItemType, StepStatus, ContextStreamChunkType } from "./context.contract.js";
 type IsoDateString = string;
 type ContextStreamEventBase = {
     type: string;
@@ -23,6 +23,14 @@ export type ContextContentUpdatedEvent = ContextStreamEventBase & {
     type: "context.content_updated";
     contextId: string;
 };
+export type ContextDefinitionUpdatedEvent = ContextStreamEventBase & {
+    type: "context.definition_updated";
+    contextId: string;
+};
+export type ContextResourcesUpdatedEvent = ContextStreamEventBase & {
+    type: "context.resources_updated";
+    contextId: string;
+};
 export type ExecutionCreatedEvent = ContextStreamEventBase & {
     type: "execution.created";
     executionId: string;
@@ -83,8 +91,6 @@ export type StepUpdatedEvent = ContextStreamEventBase & {
     executionId: string;
     iteration?: number;
     status?: StepStatus;
-    kind?: StepKind;
-    actionName?: string;
 };
 export type StepCompletedEvent = ContextStreamEventBase & {
     type: "step.completed";
@@ -129,6 +135,10 @@ export type ChunkEmittedEvent = ContextStreamEventBase & {
     stepId?: string;
     itemId?: string;
     partKey?: string;
+    partId?: string;
+    providerPartId?: string;
+    partType?: string;
+    partSlot?: string;
     actionRef?: string;
     provider?: string;
     providerChunkType?: string;
@@ -136,7 +146,7 @@ export type ChunkEmittedEvent = ContextStreamEventBase & {
     data?: unknown;
     raw?: unknown;
 };
-export type ContextLifecycleEvent = ContextCreatedEvent | ContextResolvedEvent | ContextStatusChangedEvent | ContextContentUpdatedEvent;
+export type ContextLifecycleEvent = ContextCreatedEvent | ContextResolvedEvent | ContextStatusChangedEvent | ContextContentUpdatedEvent | ContextDefinitionUpdatedEvent | ContextResourcesUpdatedEvent;
 export type ExecutionEvent = ExecutionCreatedEvent | ExecutionCompletedEvent | ExecutionFailedEvent;
 export type ItemEvent = ItemCreatedEvent | ItemUpdatedEvent | ItemPendingEvent | ItemCompletedEvent;
 export type StepEvent = StepCreatedEvent | StepUpdatedEvent | StepCompletedEvent | StepFailedEvent;

package/dist/context.stream.js

@@ -1,4 +1,5 @@
 import { isContextStreamChunkType } from "./context.contract.js";
+import { assertValidContextPartChunkIdentity } from "./context.part-identity.js";
 function assertObject(value, label) {
     if (!value || typeof value !== "object") {
         throw new Error(`Invalid ${label}: expected object.`);
@@ -14,6 +15,12 @@ function assertNumber(value, label) {
         throw new Error(`Invalid ${label}: expected number.`);
     }
 }
+function assertPositiveInteger(value, label) {
+    assertNumber(value, label);
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new Error(`Invalid ${label}: expected positive integer.`);
+    }
+}
 function assertOptionalString(value, label) {
     if (value !== undefined) {
         assertString(value, label);
@@ -41,6 +48,14 @@ export function parseContextStreamEvent(value) {
             assertString(value.contextId, `${type}.contextId`);
             return value;
         }
+        case "context.definition_updated": {
+            assertString(value.contextId, `${type}.contextId`);
+            return value;
+        }
+        case "context.resources_updated": {
+            assertString(value.contextId, `${type}.contextId`);
+            return value;
+        }
         case "execution.created":
         case "execution.completed":
         case "execution.failed": {
@@ -85,8 +100,6 @@ export function parseContextStreamEvent(value) {
             if (value.iteration !== undefined)
                 assertNumber(value.iteration, `${type}.iteration`);
             assertOptionalString(value.status, `${type}.status`);
-            assertOptionalString(value.kind, `${type}.kind`);
-            assertOptionalString(value.actionName, `${type}.actionName`);
             return value;
         }
         case "step.completed":
@@ -121,10 +134,25 @@ export function parseContextStreamEvent(value) {
             assertOptionalString(value.stepId, `${type}.stepId`);
             assertOptionalString(value.itemId, `${type}.itemId`);
             assertOptionalString(value.partKey, `${type}.partKey`);
+            assertOptionalString(value.partId, `${type}.partId`);
+            assertOptionalString(value.providerPartId, `${type}.providerPartId`);
+            assertOptionalString(value.partType, `${type}.partType`);
+            assertOptionalString(value.partSlot, `${type}.partSlot`);
             assertOptionalString(value.actionRef, `${type}.actionRef`);
             assertOptionalString(value.provider, `${type}.provider`);
             assertOptionalString(value.providerChunkType, `${type}.providerChunkType`);
-            assertOptionalNumber(value.sequence, `${type}.sequence`);
+            assertPositiveInteger(value.sequence, `${type}.sequence`);
+            assertValidContextPartChunkIdentity({
+                label: type,
+                chunkType: value.chunkType,
+                stepId: typeof value.stepId === "string" ? value.stepId : undefined,
+                partId: typeof value.partId === "string" ? value.partId : undefined,
+                provider: typeof value.provider === "string" ? value.provider : undefined,
+                providerPartId: typeof value.providerPartId === "string" ? value.providerPartId : undefined,
+                partType: typeof value.partType === "string" ? value.partType : undefined,
+                partSlot: typeof value.partSlot === "string" ? value.partSlot : undefined,
+                actionRef: typeof value.actionRef === "string" ? value.actionRef : undefined,
+            });
             return value;
         }
         default:

package/dist/domain.d.ts

@@ -0,0 +1 @@
+export { eventsDomain } from "./schema.js";

package/dist/domain.js

@@ -0,0 +1 @@
+export { eventsDomain } from "./schema.js";

package/dist/index.d.ts

@@ -1,18 +1,21 @@
-export { context, createContext, createAiSdkReactor, createScriptedReactor, type CreateAiSdkReactorOptions, type CreateScriptedReactorOptions, type ScriptedReactorStep, type ContextConfig, type ContextInstance, type ContextOptions, type ContextStreamOptions, type ContextReactor, type ContextReactorParams, type ContextReactionResult, type ContextActionRequest, type ContextReactionLLM, ContextEngine, type RegistrableContextBuilder, type ContextReactParams, type ContextReactResult, type ContextWorkflowRun, type ContextDurableWorkflowPayload, type ContextDurableWorkflowFunction, type ContextModelInit, type ContextTool, type ContextToolExecuteContext, runContextReactionDirect, } from "./context.js";
-export type { ContextStore, ContextIdentifier, StoredContext, ContextItem, ContextExecution, } from "./context.store.js";
+export { context, createContext, createAiSdkReactor, createScriptedReactor, type CreateAiSdkReactorOptions, type CreateScriptedReactorOptions, type ScriptedReactorStep, type ContextConfig, type ContextResourcesParams, type ContextInstance, type ContextOptions, type ContextStreamOptions, type ContextReactor, type ContextReactorParams, type ContextReactionResult, type ContextActionRequest, type ContextReactionLLM, ContextEngine, defineAction, action, type RegistrableContextBuilder, type ContextReactParams, type ContextDirectReactParams, type ContextDurableReactParams, type ContextReactResult, type ContextReactBase, type ContextReactFinalResult, type ContextDirectRun, type ContextReactRun, type ContextWorkflowRun, type ContextDurableWorkflowPayload, type ContextDurableWorkflowFunction, type ContextModelInit, type ContextTool, type ContextAction, type ContextActionBase, type ContextActionExecuteParams, type AnyContextAction, type ContextActionDefinition, type DefineContextActionDefinition, type DefineContextActionExecute, type LegacyContextActionDefinition, type LegacyContextActionExecute, type ContextActionExecute, type ContextActionInput, type ContextActionOutput, type ContextProviderDefinedAction, type ContextActionSchema, type ContextToolExecuteContext, runContextReactionDirect, } from "./context.js";
+export type { ContextStore, ContextIdentifier, StoredContext, ContextResource, ContextResourceBase, ContextFileResource, ContextLinkResource, ContextRepositoryResource, ContextDatasetResource, ContextExternalResource, StoredContextResource, ContextItem, ContextExecution, } from "./context.store.js";
 export type { WireDate, ContextMirrorContext, ContextMirrorExecution, ContextMirrorWrite, ContextMirrorRequest, } from "./mirror.js";
 export { registerContext, getContext, getContextFactory, hasContext, listContexts, type ContextKey, } from "./context.registry.js";
 export { eventsDomain } from "./schema.js";
-export { didToolExecute, extractToolCallsFromParts } from "./context.toolcalls.js";
-export { contextPartSchema, contextPartEnvelopeSchema, contextPartContentSchema, isContextPartEnvelope, parseContextPartEnvelope, normalizePartsForPersistence, } from "./context.parts.js";
-export type { ContextPart, ContextPartEnvelope, ContextPartContent, } from "./context.parts.js";
+export { didActionExecute, extractActionCallsFromParts, type ContextActionCall, } from "./context.action-calls.js";
+export { actionsToActionSpecs, actionSpecToAiSdkTool, type SerializableActionSpec, type SerializableFunctionActionSpec, type SerializableProviderDefinedActionSpec, } from "./tools-to-model-tools.js";
+export { reactorMetadataSchema, contextPartSchema, contextPartEnvelopeSchema, contextPartContentSchema, contextMessagePartSchema, contextReasoningPartSchema, contextSourcePartSchema, contextActionPartSchema, contextEnginePartSchema, createContextPartSchema, parseContextPart, isContextPartEnvelope, parseContextPartEnvelope, normalizePartsForPersistence, } from "./context.parts.js";
+export type { ReactorMetadata, ContextEnginePart, ContextActionPart, ContextActionStartedPart, ContextActionCompletedPart, ContextActionFailedPart, ContextPartActionMap, ContextPart, ContextPartEnvelope, ContextPartContent, ContextInlineContent, } from "./context.parts.js";
 export { INPUT_ITEM_TYPE, INPUT_TEXT_ITEM_TYPE, OUTPUT_ITEM_TYPE, WEB_CHANNEL, AGENT_CHANNEL, EMAIL_CHANNEL, createUserItemFromUIMessages, createAssistantItemFromUIMessages, convertToUIMessage, convertItemToModelMessages, convertItemsToModelMessages, convertModelMessageToItem, isContextOutputPart, normalizeContextOutputPart, type ResponseMessage, type ContextOutputPart, type ContextOutputContentPart, } from "./context.events.js";
-export { CONTEXT_STATUSES, EXECUTION_STATUSES, STEP_STATUSES, STEP_KINDS, ITEM_STATUSES, ITEM_TYPES, CHANNELS, TRACE_EVENT_KINDS, CONTEXT_STREAM_CHUNK_TYPES, STREAM_LIFECYCLE_CHUNK_TYPES, STREAM_TEXT_CHUNK_TYPES, STREAM_REASONING_CHUNK_TYPES, STREAM_ACTION_CHUNK_TYPES, STREAM_SOURCE_CHUNK_TYPES, STREAM_METADATA_CHUNK_TYPES, STREAM_ERROR_CHUNK_TYPES, CONTEXT_TRANSITIONS, EXECUTION_TRANSITIONS, STEP_TRANSITIONS, ITEM_TRANSITIONS, canContextTransition, canExecutionTransition, canStepTransition, canItemTransition, assertContextTransition, assertExecutionTransition, assertStepTransition, assertItemTransition, isContextStreamChunkType, assertContextPartKey, } from "./context.contract.js";
-export type { Transition, ContextStatus, ExecutionStatus, StepStatus, StepKind, ItemStatus, ItemType, Channel, TraceEventKind, ContextStreamChunkType, ContextTransition, ExecutionTransition, StepTransition, ItemTransition, } from "./context.contract.js";
+export { CONTEXT_STATUSES, EXECUTION_STATUSES, STEP_STATUSES, ITEM_STATUSES, ITEM_TYPES, CHANNELS, TRACE_EVENT_KINDS, CONTEXT_STREAM_CHUNK_TYPES, STREAM_LIFECYCLE_CHUNK_TYPES, STREAM_TEXT_CHUNK_TYPES, STREAM_REASONING_CHUNK_TYPES, STREAM_ACTION_CHUNK_TYPES, STREAM_SOURCE_CHUNK_TYPES, STREAM_METADATA_CHUNK_TYPES, STREAM_ERROR_CHUNK_TYPES, CONTEXT_TRANSITIONS, EXECUTION_TRANSITIONS, STEP_TRANSITIONS, ITEM_TRANSITIONS, canContextTransition, canExecutionTransition, canStepTransition, canItemTransition, assertContextTransition, assertExecutionTransition, assertStepTransition, assertItemTransition, isContextStreamChunkType, assertContextPartKey, } from "./context.contract.js";
+export type { Transition, ContextStatus, ExecutionStatus, StepStatus, ItemStatus, ItemType, Channel, TraceEventKind, ContextStreamChunkType, ContextTransition, ExecutionTransition, StepTransition, ItemTransition, } from "./context.contract.js";
 export { DEFAULT_CODEX_TOOL_NAME, DEFAULT_CODEX_MODEL, codexToolInputSchema, buildDefaultCodexNarrative, didCodexToolExecute, createCodexContextBuilder, type CodexContextRuntimeMode, type CodexContextReasoningLevel, type CodexContextRuntime, type CodexContextEnv, type CodexToolInput, type CodexToolOutput, type CodexExecuteArgs, type CodexContextBuilderConfig, type CodexContextBuilder, } from "./codex.js";
-export { useContext, type ContextSnapshot, type ContextStreamChunk, type UseContextOptions, } from "./react.js";
 export { parseContextStreamEvent, assertContextStreamTransitions, validateContextStreamTimeline, } from "./context.stream.js";
-export { CONTEXT_STEP_STREAM_VERSION, createContextStepStreamChunk, parseContextStepStreamChunk, encodeContextStepStreamChunk, } from "./context.step-stream.js";
-export type { ContextStreamEvent, ContextCreatedEvent, ContextResolvedEvent, ContextStatusChangedEvent, ContextContentUpdatedEvent, ExecutionCreatedEvent, ExecutionCompletedEvent, ExecutionFailedEvent, ItemCreatedEvent, ItemUpdatedEvent, ItemPendingEvent, ItemCompletedEvent, StepCreatedEvent, StepUpdatedEvent, StepCompletedEvent, StepFailedEvent, PartCreatedEvent, PartUpdatedEvent, ChunkEmittedEvent, } from "./context.stream.js";
+export { CONTEXT_STEP_STREAM_VERSION, createContextStepStreamChunk, validateContextStepStreamChunk, parseContextStepStreamChunk, encodeContextStepStreamChunk, } from "./context.step-stream.js";
+export type { ContextStepStreamChunkValidationOptions, } from "./context.step-stream.js";
+export { CONTEXT_PART_ID_NAMESPACE, CONTEXT_PART_UUID_RE, CONTEXT_STREAM_PART_TYPES, assertValidContextPartChunkIdentity, resolveContextPartChunkDescriptor, resolveContextPartChunkIdentity, resolveContextPartId, resolveContextStreamPartSlot, resolveContextStreamPartType, uuidV5, } from "./context.part-identity.js";
+export type { ContextPartChunkDescriptor, ContextPartChunkIdentity, ContextPartChunkIdentityInput, ContextPartChunkValidationInput, ContextStreamPartSlot, ContextStreamPartType, } from "./context.part-identity.js";
+export type { ContextStreamEvent, ContextCreatedEvent, ContextResolvedEvent, ContextStatusChangedEvent, ContextContentUpdatedEvent, ContextDefinitionUpdatedEvent, ContextResourcesUpdatedEvent, ExecutionCreatedEvent, ExecutionCompletedEvent, ExecutionFailedEvent, ItemCreatedEvent, ItemUpdatedEvent, ItemPendingEvent, ItemCompletedEvent, StepCreatedEvent, StepUpdatedEvent, StepCompletedEvent, StepFailedEvent, PartCreatedEvent, PartUpdatedEvent, ChunkEmittedEvent, } from "./context.stream.js";
 export type { ContextStepStreamChunk } from "./context.step-stream.js";
 export type { ContextSkillPackage, ContextSkillPackageFile } from "./context.skill.js";

package/dist/index.js

@@ -1,11 +1,12 @@
-export { context, createContext, createAiSdkReactor, createScriptedReactor, ContextEngine, runContextReactionDirect, } from "./context.js";
+export { context, createContext, createAiSdkReactor, createScriptedReactor, ContextEngine, defineAction, action, runContextReactionDirect, } from "./context.js";
 export { registerContext, getContext, getContextFactory, hasContext, listContexts, } from "./context.registry.js";
 export { eventsDomain } from "./schema.js";
-export { didToolExecute, extractToolCallsFromParts } from "./context.toolcalls.js";
-export { contextPartSchema, contextPartEnvelopeSchema, contextPartContentSchema, isContextPartEnvelope, parseContextPartEnvelope, normalizePartsForPersistence, } from "./context.parts.js";
+export { didActionExecute, extractActionCallsFromParts, } from "./context.action-calls.js";
+export { actionsToActionSpecs, actionSpecToAiSdkTool, } from "./tools-to-model-tools.js";
+export { reactorMetadataSchema, contextPartSchema, contextPartEnvelopeSchema, contextPartContentSchema, contextMessagePartSchema, contextReasoningPartSchema, contextSourcePartSchema, contextActionPartSchema, contextEnginePartSchema, createContextPartSchema, parseContextPart, isContextPartEnvelope, parseContextPartEnvelope, normalizePartsForPersistence, } from "./context.parts.js";
 export { INPUT_ITEM_TYPE, INPUT_TEXT_ITEM_TYPE, OUTPUT_ITEM_TYPE, WEB_CHANNEL, AGENT_CHANNEL, EMAIL_CHANNEL, createUserItemFromUIMessages, createAssistantItemFromUIMessages, convertToUIMessage, convertItemToModelMessages, convertItemsToModelMessages, convertModelMessageToItem, isContextOutputPart, normalizeContextOutputPart, } from "./context.events.js";
-export { CONTEXT_STATUSES, EXECUTION_STATUSES, STEP_STATUSES, STEP_KINDS, ITEM_STATUSES, ITEM_TYPES, CHANNELS, TRACE_EVENT_KINDS, CONTEXT_STREAM_CHUNK_TYPES, STREAM_LIFECYCLE_CHUNK_TYPES, STREAM_TEXT_CHUNK_TYPES, STREAM_REASONING_CHUNK_TYPES, STREAM_ACTION_CHUNK_TYPES, STREAM_SOURCE_CHUNK_TYPES, STREAM_METADATA_CHUNK_TYPES, STREAM_ERROR_CHUNK_TYPES, CONTEXT_TRANSITIONS, EXECUTION_TRANSITIONS, STEP_TRANSITIONS, ITEM_TRANSITIONS, canContextTransition, canExecutionTransition, canStepTransition, canItemTransition, assertContextTransition, assertExecutionTransition, assertStepTransition, assertItemTransition, isContextStreamChunkType, assertContextPartKey, } from "./context.contract.js";
+export { CONTEXT_STATUSES, EXECUTION_STATUSES, STEP_STATUSES, ITEM_STATUSES, ITEM_TYPES, CHANNELS, TRACE_EVENT_KINDS, CONTEXT_STREAM_CHUNK_TYPES, STREAM_LIFECYCLE_CHUNK_TYPES, STREAM_TEXT_CHUNK_TYPES, STREAM_REASONING_CHUNK_TYPES, STREAM_ACTION_CHUNK_TYPES, STREAM_SOURCE_CHUNK_TYPES, STREAM_METADATA_CHUNK_TYPES, STREAM_ERROR_CHUNK_TYPES, CONTEXT_TRANSITIONS, EXECUTION_TRANSITIONS, STEP_TRANSITIONS, ITEM_TRANSITIONS, canContextTransition, canExecutionTransition, canStepTransition, canItemTransition, assertContextTransition, assertExecutionTransition, assertStepTransition, assertItemTransition, isContextStreamChunkType, assertContextPartKey, } from "./context.contract.js";
 export { DEFAULT_CODEX_TOOL_NAME, DEFAULT_CODEX_MODEL, codexToolInputSchema, buildDefaultCodexNarrative, didCodexToolExecute, createCodexContextBuilder, } from "./codex.js";
-export { useContext, } from "./react.js";
 export { parseContextStreamEvent, assertContextStreamTransitions, validateContextStreamTimeline, } from "./context.stream.js";
-export { CONTEXT_STEP_STREAM_VERSION, createContextStepStreamChunk, parseContextStepStreamChunk, encodeContextStepStreamChunk, } from "./context.step-stream.js";
+export { CONTEXT_STEP_STREAM_VERSION, createContextStepStreamChunk, validateContextStepStreamChunk, parseContextStepStreamChunk, encodeContextStepStreamChunk, } from "./context.step-stream.js";
+export { CONTEXT_PART_ID_NAMESPACE, CONTEXT_PART_UUID_RE, CONTEXT_STREAM_PART_TYPES, assertValidContextPartChunkIdentity, resolveContextPartChunkDescriptor, resolveContextPartChunkIdentity, resolveContextPartId, resolveContextStreamPartSlot, resolveContextStreamPartType, uuidV5, } from "./context.part-identity.js";

package/dist/react.context-event-parts.d.ts

@@ -0,0 +1,18 @@
+type ActionStatus = "started" | "completed" | "failed";
+export type ContextActionPartInfo = {
+    actionName: string;
+    actionCallId: string;
+    status: ActionStatus;
+    input?: unknown;
+    output?: unknown;
+    errorText?: string;
+};
+export declare function normalizeContextEventParts(parts: unknown[]): Record<string, unknown>[];
+export declare function getActionPartInfo(part: unknown): ContextActionPartInfo | null;
+export declare function getCreateMessageText(part: unknown): string;
+export declare function getPartText(part: unknown): string;
+export declare function getReasoningText(part: unknown): string;
+export declare function getReasoningState(part: unknown): string;
+export declare function getSourceParts(part: unknown): any[];
+export declare function findNormalizedToolPart(parts: unknown[], toolName: string): Record<string, unknown> | null;
+export {};