@agentick/core 0.0.1 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentick/core",
-  "version": "0.0.1",
+  "version": "0.1.9",
   "description": "Core engine for Agentick",
   "keywords": [
     "agent",
@@ -29,13 +29,18 @@
     "react-reconciler": "^0.29.2",
     "zod": "^4.2.1",
     "zod-to-json-schema": "^3.25.1",
-    "@agentick/kernel": "0.0.1",
-    "@agentick/shared": "0.0.1"
+    "@agentick/kernel": "0.1.9",
+    "@agentick/shared": "0.1.9"
   },
   "devDependencies": {
     "@types/react": "^18.2.0",
     "@types/react-reconciler": "0.28.9"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agenticklabs/agentick.git",
+    "directory": "packages/core"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "echo \"Tests run from workspace root\"",

package/dist/.tsbuildinfo

@@ -1 +0,0 @@
-{"fileNames":[],"fileInfos":[],"root":[],"options":{"composite":true,"declaration":true,"declarationMap":true,"emitDecoratorMetadata":true,"esModuleInterop":true,"experimentalDecorators":true,"jsx":4,"jsxImportSource":"react","module":200,"outDir":"./","rootDir":"../src","skipLibCheck":true,"sourceMap":true,"strict":true,"target":9,"tsBuildInfoFile":"./.tsbuildinfo","verbatimModuleSyntax":true},"version":"5.9.3"}

package/dist/agent.d.ts

@@ -1,32 +0,0 @@
-/**
- * createAgent — Level 0 entry point (no JSX required).
- *
- * Generates a component wrapping <Agent> and passes it to createApp.
- * Returns the same App interface as createApp.
- *
- * For programmatic control (hooks, conditional rendering, composition),
- * write a component with <Agent> and use createApp() instead.
- */
-import type { AppOptions, App } from "./app/types";
-import type { ToolClass } from "./tool/tool";
-import type { EngineModel } from "./model/model";
-import type { KnobDescriptor } from "./hooks/knob";
-/**
- * Configuration for creating an agent without writing JSX (Level 0).
- *
- * Pass to createAgent() to get a working App without writing components.
- * For programmatic control (conditional tools, hard knobs, custom
- * continuation), write a component with <Agent> instead (Level 1+).
- */
-export interface AgentConfig {
-    /** System prompt. Rendered as a model-visible section. */
-    system?: string;
-    /** Model adapter. */
-    model?: EngineModel;
-    /** Tools (ToolClass values from createTool). */
-    tools?: ToolClass[];
-    /** Knobs — model-visible, model-settable parameters. */
-    knobs?: Record<string, KnobDescriptor<any, any>>;
-}
-export declare function createAgent(config: AgentConfig, options?: AppOptions): App;
-//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;CAClD;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,UAAe,GAAG,GAAG,CAW9E"}

package/dist/agent.js

@@ -1,26 +0,0 @@
-/**
- * createAgent — Level 0 entry point (no JSX required).
- *
- * Generates a component wrapping <Agent> and passes it to createApp.
- * Returns the same App interface as createApp.
- *
- * For programmatic control (hooks, conditional rendering, composition),
- * write a component with <Agent> and use createApp() instead.
- */
-import React from "react";
-import { Agent } from "./jsx/components/agent";
-import { createApp } from "./tentickle-instance";
-// ============================================================================
-// createAgent
-// ============================================================================
-export function createAgent(config, options = {}) {
-    const ConfigAgent = () => React.createElement(Agent, {
-        system: config.system,
-        model: config.model,
-        tools: config.tools,
-        knobs: config.knobs,
-    });
-    ConfigAgent.displayName = "ConfigAgent";
-    return createApp(ConfigAgent, options);
-}
-//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA4BjD,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,UAAsB,EAAE;IACvE,MAAM,WAAW,GAAG,GAAG,EAAE,CACvB,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IACL,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC;IAExC,OAAO,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/aidk-instance.d.ts

@@ -1,294 +0,0 @@
-/**
- * Tentickle Configuration Instance
- *
- * `Tentickle` is the default global instance. Users interact with instances, never the class directly.
- *
- * ```typescript
- * import { Tentickle, createApp } from 'tentickle';
- *
- * // Configure global instance
- * Tentickle.use('*', loggingMiddleware);
- * Tentickle.use('tool:*', authMiddleware);
- *
- * // createApp uses Tentickle by default
- * const app = createApp(MyAgent, { model });
- *
- * // Create a scoped instance (inherits from Tentickle)
- * const scoped = Tentickle.create();
- * scoped.use('model:generate', rateLimitMiddleware);
- * const scopedApp = scoped.createApp(MyAgent, { model });
- *
- * // Create isolated instance (no inheritance)
- * const isolated = Tentickle.create({ inheritDefaults: false });
- * ```
- *
- * @module tentickle/@tentickle/instance
- */
-import { type Middleware, type TelemetryProvider, type DirectProcedure } from "./core";
-import type { App, AppInput, AppOptions, SessionExecutionHandle, ComponentFunction } from "./app/types";
-/**
- * Key for middleware registration.
- * - `'*'` - matches all procedures
- * - `'tool:*'` - matches all tool procedures
- * - `'tool:run'` - matches specific procedure
- * - `'model:generate'` - matches specific procedure
- */
-export type MiddlewareKey = string;
-/**
- * Options for creating an TentickleInstance.
- */
-export interface TentickleInstanceCreateOptions {
-    /** Telemetry provider for tracing and metrics */
-    telemetryProvider?: TelemetryProvider;
-    /**
-     * Whether to inherit middleware from the parent instance.
-     * @default true
-     */
-    inheritDefaults?: boolean;
-}
-/**
- * Interface for middleware resolution.
- * This is what gets passed to context for procedures to read at execution time.
- */
-export interface MiddlewareRegistry {
-    /**
-     * Get middleware matching a procedure name.
-     * Matches in order: '*', category wildcard ('tool:*'), exact name
-     */
-    getMiddlewareFor(procedureName: string): Middleware[];
-}
-/**
- * Handler type for the run procedure.
- * Generic P is the props type for the component.
- */
-type RunHandler = <P extends Record<string, unknown>>(element: {
-    type: ComponentFunction<P>;
-    props: P;
-    key: string | null;
-}, input?: RunInput<P>) => SessionExecutionHandle;
-/**
- * Tentickle configuration instance.
- *
- * Users interact with instances, never the class directly.
- * `Tentickle` is the default global instance.
- */
-export declare class TentickleInstance implements MiddlewareRegistry {
-    private middlewareRegistry;
-    private _telemetryProvider?;
-    /**
-     * One-shot execution of a JSX component.
-     *
-     * This is a procedure with handleFactory: false (pass-through).
-     * Returns SessionExecutionHandle which is both PromiseLike and AsyncIterable:
-     * - `await run(...)` → SendResult
-     * - `for await (const event of run(...))` → AppStreamEvent
-     *
-     * @example Await result
-     * ```typescript
-     * const result = await Tentickle.run(
-     *   <MyAgent />,
-     *   { messages: [{ role: "user", content: [...] }], model }
-     * );
-     * ```
-     *
-     * @example Stream events
-     * ```typescript
-     * for await (const event of Tentickle.run(<MyAgent />, { messages, model })) {
-     *   if (event.type === 'content_delta') {
-     *     process.stdout.write(event.delta);
-     *   }
-     * }
-     * ```
-     *
-     * @example Add middleware to run
-     * ```typescript
-     * const loggedRun = Tentickle.run.use(loggingMiddleware);
-     * const result = await loggedRun(<MyAgent />, { messages, model });
-     * ```
-     */
-    readonly run: DirectProcedure<RunHandler>;
-    /**
-     * @internal
-     */
-    constructor(options?: {
-        telemetryProvider?: TelemetryProvider;
-    });
-    /**
-     * Register middleware for a procedure pattern.
-     *
-     * Keys can be:
-     * - `'*'` - all procedures
-     * - `'tool:*'` - all tool procedures (tool:run, etc.)
-     * - `'model:*'` - all model procedures (model:generate, model:stream)
-     * - `'tool:run'` - specific procedure name
-     * - `'model:generate'` - specific procedure name
-     *
-     * Middleware is executed in order: global → category → specific
-     *
-     * @param key - Procedure pattern to match
-     * @param middleware - Middleware functions to register
-     * @returns this for chaining
-     *
-     * @example
-     * ```typescript
-     * Tentickle
-     *   .use('*', loggingMiddleware)
-     *   .use('tool:*', authMiddleware)
-     *   .use('model:generate', rateLimitMiddleware);
-     * ```
-     */
-    use(key: MiddlewareKey, ...middleware: Middleware[]): this;
-    /**
-     * Get middleware matching a procedure name.
-     *
-     * Resolution order:
-     * 1. Global ('*')
-     * 2. Category wildcard (e.g., 'tool:*' matches 'tool:run')
-     * 3. Exact match (e.g., 'tool:run')
-     *
-     * @param procedureName - The procedure name to match (e.g., 'tool:run', 'model:generate')
-     * @returns Array of middleware functions in execution order
-     */
-    getMiddlewareFor(procedureName: string): Middleware[];
-    /**
-     * Clear all registered middleware.
-     * Useful for testing or resetting state.
-     */
-    clear(): this;
-    /**
-     * Get the telemetry provider.
-     */
-    get telemetryProvider(): TelemetryProvider | undefined;
-    /**
-     * Set the telemetry provider.
-     */
-    set telemetryProvider(provider: TelemetryProvider | undefined);
-    /**
-     * Create a child instance.
-     *
-     * By default, the child inherits all middleware from this instance.
-     * Use `inheritDefaults: false` for a completely isolated instance.
-     *
-     * @param options - Instance options
-     * @returns A new TentickleInstance
-     *
-     * @example
-     * ```typescript
-     * // Create scoped instance that inherits global middleware
-     * const scoped = Tentickle.create();
-     * scoped.use('model:generate', rateLimitMiddleware);
-     * const app = scoped.createApp(MyAgent);
-     *
-     * // Create isolated instance (no inheritance)
-     * const isolated = Tentickle.create({ inheritDefaults: false });
-     * ```
-     */
-    create(options?: TentickleInstanceCreateOptions): TentickleInstance;
-    /**
-     * Create an app from a component function.
-     *
-     * The app inherits middleware from this Tentickle instance.
-     *
-     * @param Component - The component function that defines the Model Interface
-     * @param options - App configuration options
-     * @returns An App instance with run and createSession methods
-     *
-     * @example
-     * ```typescript
-     * const MyAgent = ({ query }) => (
-     *   <>
-     *     <System>You are helpful.</System>
-     *     <Timeline />
-     *     <User>{query}</User>
-     *   </>
-     * );
-     *
-     * // Use global Tentickle
-     * const app = createApp(MyAgent, { model });
-     *
-     * // Use scoped instance
-     * const scoped = Tentickle.create();
-     * scoped.use('tool:*', authMiddleware);
-     * const scopedApp = scoped.createApp(MyAgent, { model });
-     * ```
-     */
-    createApp<P extends Record<string, unknown>>(Component: ComponentFunction<P>, options?: AppOptions): App<P>;
-}
-/**
- * The default global Tentickle instance.
- *
- * All configuration and middleware registration starts here.
- * The exported `createApp` and `run` are bound to this instance.
- *
- * @example
- * ```typescript
- * import { Tentickle, createApp, run } from 'tentickle';
- *
- * // Configure global middleware
- * Tentickle.use('*', loggingMiddleware);
- * Tentickle.telemetryProvider = myProvider;
- *
- * // createApp and run use Tentickle
- * const app = createApp(MyAgent, { model });
- * const result = await run(<MyAgent />, { messages, model });
- *
- * // Create scoped instance with its own middleware
- * const scoped = Tentickle.create();
- * scoped.use('model:generate', specialMiddleware);
- * const scopedResult = await scoped.run(<MyAgent />, { messages, model });
- * ```
- */
-export declare const Tentickle: TentickleInstance;
-/**
- * Create an app from a component function.
- *
- * This is `Tentickle.createApp` - apps inherit middleware from the global Tentickle instance.
- *
- * @example
- * ```typescript
- * import { createApp } from 'tentickle';
- *
- * const app = createApp(MyAgent, { model });
- * const result = await app.run({ props: { query: "Hello!" } });
- * ```
- */
-export declare const createApp: <P extends Record<string, unknown>>(Component: ComponentFunction<P>, options?: AppOptions) => App<P>;
-/**
- * One-shot execution of a JSX component.
- *
- * This is `Tentickle.run` - the simplest way to run an agent.
- * Returns SessionExecutionHandle which is both PromiseLike and AsyncIterable.
- *
- * @example
- * ```typescript
- * import { run } from 'tentickle';
- *
- * // Await result
- * const result = await run(<MyAgent />, { messages, model });
- *
- * // Stream events
- * for await (const event of run(<MyAgent />, { messages, model })) {
- *   console.log(event);
- * }
- * ```
- */
-export declare const run: DirectProcedure<RunHandler>;
-/**
- * Input for the run() function.
- */
-export interface RunInput<P extends Record<string, unknown> = Record<string, unknown>> {
-    /** Model instance to use for execution */
-    model?: AppOptions["model"];
-    /** Props to pass to the component */
-    props?: P;
-    /** Messages to queue before running */
-    messages?: AppInput<P>["messages"];
-    /** Conversation history to seed */
-    history?: AppInput<P>["history"];
-    /** Maximum number of ticks before stopping */
-    maxTicks?: number;
-    /** Abort signal for cancellation */
-    signal?: AbortSignal;
-}
-export {};
-//# sourceMappingURL=aidk-instance.d.ts.map

package/dist/aidk-instance.d.ts.map

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