@agentier/core 0.1.0

package/dist/agent.d.ts

@@ -0,0 +1,27 @@
+import type { Agent, AgentConfig } from './types';
+/**
+ * Creates a new agent instance with the given configuration.
+ *
+ * The returned agent exposes a `run()` method for executing prompts through
+ * the configured model and tools, and a `getConfig()` method for inspecting
+ * the (frozen) configuration.
+ *
+ * @param config - The agent configuration including model, provider, tools, and limits.
+ * @returns An {@link Agent} instance.
+ *
+ * @example
+ * ```ts
+ * import { createAgent, defineTool } from '@agenti/core'
+ *
+ * const agent = createAgent({
+ *   model: 'gpt-4o',
+ *   provider: myProvider,
+ *   systemPrompt: 'You are a helpful assistant.',
+ *   tools: [searchTool],
+ * })
+ *
+ * const result = await agent.run('Find the latest news about AI.')
+ * console.log(result.output)
+ * ```
+ */
+export declare function createAgent(config: AgentConfig): Agent;

package/dist/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Discriminated error codes used by {@link AgentError} to identify the cause of failure.
+ *
+ * - `'MAX_ITERATIONS_EXCEEDED'` - The agent loop hit the maximum iteration count.
+ * - `'MAX_TOKENS_EXCEEDED'` - The total token budget was exhausted.
+ * - `'TIMEOUT'` - The run exceeded the configured wall-clock timeout.
+ * - `'ABORTED'` - The run was cancelled via an external abort signal.
+ * - `'MODEL_ERROR'` - The model provider returned an error.
+ * - `'TOOL_VALIDATION_ERROR'` - Tool arguments failed schema validation.
+ * - `'TOOL_EXECUTION_ERROR'` - A tool threw an error during execution.
+ * - `'OUTPUT_PARSE_ERROR'` - The model's output could not be parsed as structured data.
+ * - `'PROVIDER_ERROR'` - A generic provider-level error (e.g. stream ended unexpectedly).
+ */
+export type AgentErrorCode = 'MAX_ITERATIONS_EXCEEDED' | 'MAX_TOKENS_EXCEEDED' | 'TIMEOUT' | 'ABORTED' | 'MODEL_ERROR' | 'TOOL_VALIDATION_ERROR' | 'TOOL_EXECUTION_ERROR' | 'OUTPUT_PARSE_ERROR' | 'PROVIDER_ERROR';
+/**
+ * Custom error class for all agent-related failures.
+ * Extends the built-in `Error` with a machine-readable {@link code},
+ * an optional {@link cause} error, and optional {@link context} metadata.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await agent.run('...')
+ * } catch (err) {
+ *   if (err instanceof AgentError && err.code === 'TIMEOUT') {
+ *     console.log('Agent timed out')
+ *   }
+ * }
+ * ```
+ */
+export declare class AgentError extends Error {
+    readonly code: AgentErrorCode;
+    readonly cause?: Error | undefined;
+    readonly context?: Record<string, unknown> | undefined;
+    /**
+     * Creates a new AgentError.
+     *
+     * @param message - A human-readable description of the error.
+     * @param code - A machine-readable error code identifying the failure type.
+     * @param cause - The underlying error that caused this failure, if any.
+     * @param context - Additional metadata about the error context (e.g. tool name, iteration count).
+     */
+    constructor(message: string, code: AgentErrorCode, cause?: Error | undefined, context?: Record<string, unknown> | undefined);
+}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@agenti/core` - The core agent framework for building LLM-powered agents with tool use.
+ *
+ * This package provides the foundational primitives for creating agents that
+ * can reason, invoke tools, and maintain conversation state:
+ *
+ * - {@link createAgent} - Factory function for creating agent instances.
+ * - {@link defineTool} - Helper for defining type-safe tools with Zod or JSON Schema.
+ * - {@link AgentError} - Structured error class for agent failures.
+ *
+ * @module @agenti/core
+ */
+export { createAgent } from './agent';
+export { defineTool } from './tool';
+export { AgentError } from './errors';
+export type { AgentErrorCode } from './errors';
+export type { Role, ToolCall, Message, ToolContext, JsonSchema, ToolJsonSchema, Tool, ChatParams, ModelResponse, StreamEvent, ModelProvider, AgentActionType, ActionPayloadMap, AgentAction, Middleware, MemoryProvider, AgentConfig, ExecutedToolCall, UsageStats, AgentResult, RunOptions, Agent, } from './types';