@agentick/core 0.0.1

package/dist/jsx/components/messages.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Message Role Components
+ *
+ * Semantic components for each message role.
+ * These are sugar wrappers around the Message primitive with role pre-set.
+ *
+ * Usage:
+ *   <User>What's the weather?</User>
+ *   <Assistant>It's sunny today.</Assistant>
+ *   <System>You are a helpful assistant.</System>
+ *   <Ephemeral position="before-user">Current state: ...</Ephemeral>
+ *   <Event>User completed checkout</Event>
+ *   <ToolResult toolCallId="..." name="weather">Sunny, 72°F</ToolResult>
+ */
+import React from "react";
+import type { JSX } from "react";
+import type { ContentBlock, EventAllowedBlock } from "@agentick/shared";
+import { type MessageProps } from "./primitives";
+import type { EphemeralPosition } from "../../com/types";
+/**
+ * Base props shared by all role-specific message components.
+ */
+export interface RoleMessageBaseProps {
+    /** Unique identifier for the message */
+    id?: string;
+    /** Message content - can be string, ContentBlock[], or JSX children */
+    content?: string | ContentBlock[];
+    /** JSX children - will be collected into content */
+    children?: any;
+    /** Tags for categorization/filtering */
+    tags?: string[];
+    /** Visibility scope */
+    visibility?: "model" | "observer" | "log";
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+export interface UserProps extends RoleMessageBaseProps {
+}
+/**
+ * User message component.
+ *
+ * @example
+ * <User>What's the weather today?</User>
+ * <User content="Hello" tags={['greeting']} />
+ */
+export declare function User(props: UserProps): React.FunctionComponentElement<MessageProps>;
+export interface AssistantProps extends RoleMessageBaseProps {
+}
+/**
+ * Assistant message component.
+ *
+ * @example
+ * <Assistant>The weather is sunny today.</Assistant>
+ * <Assistant content={responseBlocks} />
+ */
+export declare function Assistant(props: AssistantProps): React.FunctionComponentElement<MessageProps>;
+export interface SystemProps extends RoleMessageBaseProps {
+}
+/**
+ * System message component.
+ *
+ * For static instructions and role definitions.
+ * For dynamic state/context, consider using <Grounding> instead.
+ *
+ * @example
+ * <System>You are a helpful assistant.</System>
+ */
+export declare function System(props: SystemProps): React.FunctionComponentElement<MessageProps>;
+export interface ToolResultProps extends RoleMessageBaseProps {
+    /** The ID of the tool call this result responds to */
+    toolCallId: string;
+    /** The name of the tool */
+    name?: string;
+    /** Whether this result represents an error */
+    isError?: boolean;
+}
+/**
+ * Tool result message component.
+ *
+ * @example
+ * <ToolResult toolCallId="call_123" name="weather">
+ *   {"temperature": 72, "condition": "sunny"}
+ * </ToolResult>
+ */
+export declare function ToolResult(props: ToolResultProps): React.FunctionComponentElement<MessageProps>;
+export interface EventProps extends RoleMessageBaseProps {
+    /** Event type for categorization */
+    eventType?: string;
+    /** Content restricted to event-allowed blocks */
+    content?: EventAllowedBlock[] | string;
+}
+/**
+ * Event message component.
+ *
+ * For recording application events that are part of the conversation history.
+ * Events are persisted and represent things that happened (user actions,
+ * system events, state changes).
+ *
+ * Use with event block components (UserAction, SystemEvent, StateChange) for
+ * semantic structure with formatted text.
+ *
+ * @example
+ * <Event>
+ *   <UserAction action="checkout" actor="user">
+ *     User initiated checkout at {timestamp}
+ *   </UserAction>
+ * </Event>
+ *
+ * <Event>
+ *   <SystemEvent event="payment_processed" source="stripe">
+ *     Payment of $99.00 processed successfully
+ *   </SystemEvent>
+ * </Event>
+ */
+export declare function Event(props: EventProps): React.FunctionComponentElement<MessageProps>;
+export interface UserActionProps {
+    /** The action performed */
+    action: string;
+    /** Who performed the action */
+    actor?: string;
+    /** Target of the action */
+    target?: string;
+    /** Additional details */
+    details?: Record<string, any>;
+    /** Formatted text (from children) */
+    children?: string;
+}
+/**
+ * User action block component.
+ *
+ * Creates a semantic user_action block with formatted text from children.
+ * Use inside <Event> messages.
+ *
+ * @example
+ * <Event>
+ *   <UserAction action="add_to_cart" actor="user" target="product-123">
+ *     User added "Widget Pro" to cart
+ *   </UserAction>
+ * </Event>
+ */
+export declare function UserAction(props: UserActionProps): JSX.Element;
+export interface SystemEventProps {
+    /** The event that occurred */
+    event: string;
+    /** Source system/component */
+    source?: string;
+    /** Additional event data */
+    data?: Record<string, any>;
+    /** Formatted text (from children) */
+    children?: string;
+}
+/**
+ * System event block component.
+ *
+ * Creates a semantic system_event block with formatted text from children.
+ * Use inside <Event> messages.
+ *
+ * @example
+ * <Event>
+ *   <SystemEvent event="order_created" source="order-service">
+ *     Order #12345 created with 3 items
+ *   </SystemEvent>
+ * </Event>
+ */
+export declare function SystemEvent(props: SystemEventProps): JSX.Element;
+export interface StateChangeProps {
+    /** The entity that changed */
+    entity: string;
+    /** The field that changed */
+    field?: string;
+    /** Previous value */
+    from: any;
+    /** New value */
+    to: any;
+    /** What triggered the change */
+    trigger?: string;
+    /** Formatted text (from children) */
+    children?: string;
+}
+/**
+ * State change block component.
+ *
+ * Creates a semantic state_change block with formatted text from children.
+ * Use inside <Event> messages.
+ *
+ * @example
+ * <Event>
+ *   <StateChange entity="order" field="status" from="pending" to="shipped" trigger="fulfillment">
+ *     Order status changed from pending to shipped
+ *   </StateChange>
+ * </Event>
+ */
+export declare function StateChange(props: StateChangeProps): JSX.Element;
+export type { EphemeralPosition } from "../../com/types";
+export interface EphemeralProps {
+    /**
+     * Type/category of ephemeral content.
+     * Used for semantic categorization and can be used by model config
+     * to apply type-specific formatting (delimiters, etc.)
+     */
+    type?: string;
+    /** Ephemeral content - can be string, ContentBlock[], or JSX children */
+    content?: string | ContentBlock[];
+    /** JSX children - will be collected into content */
+    children?: any;
+    /**
+     * Position in the message list (CSS-inspired).
+     * @default 'end'
+     */
+    position?: EphemeralPosition;
+    /**
+     * Ordering within the position group.
+     * Lower numbers appear first.
+     * @default 0
+     */
+    order?: number;
+    /** Optional identifier for debugging/tracing */
+    id?: string;
+    /** Tags for categorization/filtering */
+    tags?: string[];
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Ephemeral content primitive.
+ *
+ * Ephemeral content is NOT persisted - it provides current state/context
+ * to the model but is not part of the conversation history. It is rebuilt
+ * fresh each tick.
+ *
+ * The compiler recognizes this component and adds its content to
+ * `ctx.ephemeral` rather than the timeline.
+ *
+ * @example
+ * <Ephemeral type="account_balance" position="before-user">
+ *   Current balance: ${balance}
+ * </Ephemeral>
+ *
+ * <Ephemeral type="tools" position="start" order={10}>
+ *   Available tools: {toolList}
+ * </Ephemeral>
+ */
+export declare function Ephemeral(props: EphemeralProps): JSX.Element;
+export interface GroundingProps extends EphemeralProps {
+    /**
+     * Optional title/heading for this grounding context.
+     * Rendered as a header before the content.
+     */
+    title?: string;
+    /**
+     * Intended audience for this context.
+     * @default 'model'
+     */
+    audience?: "model" | "user" | "both";
+}
+/**
+ * Grounding component - semantic wrapper for Ephemeral.
+ *
+ * For dynamic state and world information that the model should be aware of.
+ * This is ephemeral content (not persisted) that provides current context.
+ *
+ * Formatting (delimiters, etc.) is configured at the model level via
+ * `modelOptions.messageTransformation`, not in JSX props.
+ *
+ * @example
+ * // Basic usage with title
+ * <Grounding title="Current State">
+ *   Active todos: {JSON.stringify(todos)}
+ * </Grounding>
+ *
+ * // Positioned before user's message
+ * <Grounding title="User Preferences" position="before-user">
+ *   Theme: dark, Language: en
+ * </Grounding>
+ *
+ * // With type for semantic categorization
+ * <Grounding type="system_state" audience="model">
+ *   {stateJson}
+ * </Grounding>
+ */
+export declare function Grounding(props: GroundingProps): JSX.Element;
+export { Message } from "./primitives";
+//# sourceMappingURL=messages.d.ts.map

package/dist/jsx/components/messages.d.ts.map

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

package/dist/jsx/components/messages.js

@@ -0,0 +1,257 @@
+/**
+ * Message Role Components
+ *
+ * Semantic components for each message role.
+ * These are sugar wrappers around the Message primitive with role pre-set.
+ *
+ * Usage:
+ *   <User>What's the weather?</User>
+ *   <Assistant>It's sunny today.</Assistant>
+ *   <System>You are a helpful assistant.</System>
+ *   <Ephemeral position="before-user">Current state: ...</Ephemeral>
+ *   <Event>User completed checkout</Event>
+ *   <ToolResult toolCallId="..." name="weather">Sunny, 72°F</ToolResult>
+ */
+import React, { useDebugValue } from "react";
+import { Message as MessagePrimitive } from "./primitives";
+// Helper for createElement
+const h = React.createElement;
+/**
+ * User message component.
+ *
+ * @example
+ * <User>What's the weather today?</User>
+ * <User content="Hello" tags={['greeting']} />
+ */
+export function User(props) {
+    const { content, children, ...rest } = props;
+    useDebugValue("User message");
+    return h(MessagePrimitive, {
+        role: "user",
+        content,
+        children,
+        ...rest,
+    });
+}
+/**
+ * Assistant message component.
+ *
+ * @example
+ * <Assistant>The weather is sunny today.</Assistant>
+ * <Assistant content={responseBlocks} />
+ */
+export function Assistant(props) {
+    const { content, children, ...rest } = props;
+    useDebugValue("Assistant message");
+    return h(MessagePrimitive, {
+        role: "assistant",
+        content,
+        children,
+        ...rest,
+    });
+}
+/**
+ * System message component.
+ *
+ * For static instructions and role definitions.
+ * For dynamic state/context, consider using <Grounding> instead.
+ *
+ * @example
+ * <System>You are a helpful assistant.</System>
+ */
+export function System(props) {
+    const { content, children, ...rest } = props;
+    useDebugValue("System prompt");
+    return h(MessagePrimitive, {
+        role: "system",
+        content,
+        children,
+        ...rest,
+    });
+}
+/**
+ * Tool result message component.
+ *
+ * @example
+ * <ToolResult toolCallId="call_123" name="weather">
+ *   {"temperature": 72, "condition": "sunny"}
+ * </ToolResult>
+ */
+export function ToolResult(props) {
+    const { content, children, toolCallId, name, isError, ...rest } = props;
+    useDebugValue(`ToolResult: ${name ?? toolCallId}`);
+    return h(MessagePrimitive, {
+        role: "tool",
+        content,
+        children,
+        metadata: {
+            ...rest.metadata,
+            tool_call_id: toolCallId,
+            tool_name: name,
+            isError: isError,
+        },
+        ...rest,
+    });
+}
+/**
+ * Event message component.
+ *
+ * For recording application events that are part of the conversation history.
+ * Events are persisted and represent things that happened (user actions,
+ * system events, state changes).
+ *
+ * Use with event block components (UserAction, SystemEvent, StateChange) for
+ * semantic structure with formatted text.
+ *
+ * @example
+ * <Event>
+ *   <UserAction action="checkout" actor="user">
+ *     User initiated checkout at {timestamp}
+ *   </UserAction>
+ * </Event>
+ *
+ * <Event>
+ *   <SystemEvent event="payment_processed" source="stripe">
+ *     Payment of $99.00 processed successfully
+ *   </SystemEvent>
+ * </Event>
+ */
+export function Event(props) {
+    const { content, children, eventType, ...rest } = props;
+    useDebugValue(`Event: ${eventType ?? "generic"}`);
+    return h(MessagePrimitive, {
+        role: "event",
+        content,
+        children,
+        metadata: {
+            ...rest.metadata,
+            event_type: eventType,
+        },
+        ...rest,
+    });
+}
+/**
+ * User action block component.
+ *
+ * Creates a semantic user_action block with formatted text from children.
+ * Use inside <Event> messages.
+ *
+ * @example
+ * <Event>
+ *   <UserAction action="add_to_cart" actor="user" target="product-123">
+ *     User added "Widget Pro" to cart
+ *   </UserAction>
+ * </Event>
+ */
+export function UserAction(props) {
+    // Return JSX element - compiler will convert to block via registry
+    return h(UserAction, props);
+}
+/**
+ * System event block component.
+ *
+ * Creates a semantic system_event block with formatted text from children.
+ * Use inside <Event> messages.
+ *
+ * @example
+ * <Event>
+ *   <SystemEvent event="order_created" source="order-service">
+ *     Order #12345 created with 3 items
+ *   </SystemEvent>
+ * </Event>
+ */
+export function SystemEvent(props) {
+    // Return JSX element - compiler will convert to block via registry
+    return h(SystemEvent, props);
+}
+/**
+ * State change block component.
+ *
+ * Creates a semantic state_change block with formatted text from children.
+ * Use inside <Event> messages.
+ *
+ * @example
+ * <Event>
+ *   <StateChange entity="order" field="status" from="pending" to="shipped" trigger="fulfillment">
+ *     Order status changed from pending to shipped
+ *   </StateChange>
+ * </Event>
+ */
+export function StateChange(props) {
+    // Return JSX element - compiler will convert to block via registry
+    return h(StateChange, props);
+}
+/**
+ * Ephemeral content primitive.
+ *
+ * Ephemeral content is NOT persisted - it provides current state/context
+ * to the model but is not part of the conversation history. It is rebuilt
+ * fresh each tick.
+ *
+ * The compiler recognizes this component and adds its content to
+ * `ctx.ephemeral` rather than the timeline.
+ *
+ * @example
+ * <Ephemeral type="account_balance" position="before-user">
+ *   Current balance: ${balance}
+ * </Ephemeral>
+ *
+ * <Ephemeral type="tools" position="start" order={10}>
+ *   Available tools: {toolList}
+ * </Ephemeral>
+ */
+export function Ephemeral(props) {
+    useDebugValue(`Ephemeral: ${props.type ?? "content"} @ ${props.position ?? "end"}`);
+    // Self-reference so compiler can recognize this component type
+    return h(Ephemeral, props);
+}
+/**
+ * Grounding component - semantic wrapper for Ephemeral.
+ *
+ * For dynamic state and world information that the model should be aware of.
+ * This is ephemeral content (not persisted) that provides current context.
+ *
+ * Formatting (delimiters, etc.) is configured at the model level via
+ * `modelOptions.messageTransformation`, not in JSX props.
+ *
+ * @example
+ * // Basic usage with title
+ * <Grounding title="Current State">
+ *   Active todos: {JSON.stringify(todos)}
+ * </Grounding>
+ *
+ * // Positioned before user's message
+ * <Grounding title="User Preferences" position="before-user">
+ *   Theme: dark, Language: en
+ * </Grounding>
+ *
+ * // With type for semantic categorization
+ * <Grounding type="system_state" audience="model">
+ *   {stateJson}
+ * </Grounding>
+ */
+export function Grounding(props) {
+    const { content, children, type, position = "start", order, audience = "model", title, id, tags, metadata, } = props;
+    useDebugValue(`Grounding: ${title ?? type ?? "context"}`);
+    return h(Ephemeral, {
+        type,
+        content,
+        children,
+        position,
+        order,
+        id,
+        tags,
+        metadata: {
+            ...metadata,
+            _grounding: {
+                audience,
+                title,
+            },
+        },
+    });
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export { Message } from "./primitives";
+//# sourceMappingURL=messages.js.map

package/dist/jsx/components/messages.js.map

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

package/dist/jsx/components/model.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Model component - React function component version.
+ *
+ * Uses React hooks (useEffect) for lifecycle instead of Agentick Component class.
+ */
+import React from "react";
+import type { ModelConfig, EngineModel } from "../../model/model";
+import type { ComponentBaseProps } from "../jsx-types";
+import type { ProviderGenerationOptions } from "../../types";
+import type { MessageTransformationConfig } from "../../model/model";
+import type { COM } from "../../com/object-model";
+/**
+ * Props for Model component.
+ */
+export interface ModelComponentProps extends ComponentBaseProps, Omit<ModelConfig, "model"> {
+    /**
+     * The model adapter instance or identifier.
+     * If a string, will be resolved from the model registry.
+     */
+    model: EngineModel | string;
+    /**
+     * Provider-specific options.
+     * Used for model generation/streaming calls and other operations.
+     * Each adapter can extend this type using module augmentation.
+     */
+    providerOptions?: ProviderGenerationOptions;
+    /**
+     * Optional callback when model is mounted.
+     */
+    onMount?: (ctx: COM) => Promise<void> | void;
+    /**
+     * Optional callback when model is unmounted.
+     */
+    onUnmount?: (ctx: COM) => Promise<void> | void;
+}
+/**
+ * Model component that dynamically sets the model adapter for the current execution.
+ *
+ * Model is a configuration component - it sets which model adapter to use.
+ * It does NOT contain content (messages, timeline entries, etc.).
+ *
+ * When mounted, sets the model on the COM.
+ * When unmounted, clears the model.
+ *
+ * @example
+ * ```tsx
+ * <>
+ *   <Model model={myModel} />
+ *   <Message role="user" content="Hello" />
+ * </>
+ * ```
+ */
+export declare function Model(props: ModelComponentProps): React.ReactElement;
+export declare const ModelComponent: typeof Model;
+/**
+ * Props for ModelOptions component.
+ * Configuration for how content is transformed for model input.
+ */
+export interface ModelOptionsProps extends ComponentBaseProps {
+    /**
+     * Unified message transformation configuration.
+     * Controls how event and ephemeral messages are transformed for the model.
+     * Can override model-level defaults set in adapter capabilities.
+     *
+     * @see MessageTransformationConfig
+     */
+    messageTransformation?: Partial<MessageTransformationConfig>;
+    /**
+     * Model temperature (0-2).
+     */
+    temperature?: number;
+    /**
+     * Maximum tokens to generate.
+     */
+    maxTokens?: number;
+}
+/**
+ * ModelOptions component for configuring how content is transformed for model input.
+ *
+ * @example
+ * ```tsx
+ * <ModelOptions
+ *   messageTransformation={{
+ *     roleMapping: {
+ *       event: 'user',
+ *       ephemeral: 'user',
+ *     },
+ *   }}
+ * />
+ * ```
+ */
+export declare function ModelOptions(props: ModelOptionsProps): React.ReactElement;
+export declare const ModelOptionsComponent: typeof ModelOptions;
+//# sourceMappingURL=model.d.ts.map

package/dist/jsx/components/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/jsx/components/model.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAmC,MAAM,OAAO,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAKlD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IACzF;;;OAGG;IACH,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC;IAE5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAE5C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAkDpE;AAGD,eAAO,MAAM,cAAc,cAAQ,CAAC;AAMpC;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAE7D;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAUzE;AAGD,eAAO,MAAM,qBAAqB,qBAAe,CAAC"}