genaicode 0.15.0 → 2.0.0

package/README.md

@@ -6,128 +6,303 @@
   </picture>
 </p>
 
-<div align="center">
+# GenAIcode
 
-# Programming on steroids
+GenAIcode is a small TypeScript toolkit for using LLMs in backend code.
 
-  <a href="https://www.npmjs.com/package/genaicode">
-    <img alt="npm version" src="https://img.shields.io/npm/v/genaicode.svg?style=flat-square"></a>
-  <a href="https://www.npmjs.com/package/genaicode">
-    <img alt="weekly downloads from npm" src="https://img.shields.io/npm/dw/genaicode.svg?style=flat-square"></a>
-  <a href="https://github.com/gtanczyk/genaicode/actions?query=branch%3Amaster">
-    <img alt="Github Actions Build Status" src="https://img.shields.io/github/actions/workflow/status/gtanczyk/genaicode/lint.yaml?label=Tests&style=flat-square"></a>
+It sits between raw provider SDKs and full agent frameworks: one prompt representation,
+thin provider adapters, a convenient request API, and lightweight conversation chains.
+It does not inspect repositories, execute shell commands, edit files, or run an agent UI.
 
-</div>
+## GenAIcode 2.0 is a new direction
 
----
+GenAIcode 1.x was a coding agent. Version 2.0 deliberately replaces that product with a
+small backend LLM toolkit: a jQuery-like layer for portable prompts, provider adapters,
+conversation chains, and plugins.
 
-> [!WARNING]
-> 🚧 GenAIcode is under development, use at own risk, feedback is welcomed! 🚧
+The coding-agent CLI, browser UI, repository tools, shell execution, and agent
+orchestration are not deprecated compatibility features; they have been removed from
+2.0. The GenAIcode name, `PromptItem` model, provider converters, and extensibility
+continue here in a smaller and more focused form.
 
----
+The original coding agent remains available from the preserved
+[`1.x` branch](https://github.com/gtanczyk/genaicode/tree/1.x) and the 1.x npm releases:
 
-The GenAIcode tool is designed to automate code generation tasks using various AI models. This tool enhances developer productivity by assisting with analysis, and modification of code, and image assets. Works on any code base, can modify multiple files. Can be used via web browser, as a interactive or non-interactive CLI command, as a node.js library, or as [vite plugin](./src/vite-genaicode/README.md).
+```bash
+npx genaicode@1
+```
 
-## Quick Start
+Running `npx genaicode` with version 2.x prints this migration guidance instead of
+starting the old agent.
 
-In your project root directory, run:
+See [the pivot plan](docs/pivot.md) for the full scope and migration decisions.
+
+## Install
 
 ```bash
-npx genaicode --ui
-open http://localhost:1337
+npm install genaicode
+```
+
+Node.js 20 or newer is required.
+
+## A prompt in three lines
+
+```ts
+import { genaicode } from 'genaicode';
+import { openai } from 'genaicode/providers';
+
+const ai = genaicode(openai({ model: 'your-model-name' }));
+const answer = await ai('Explain why the sky is blue in two sentences.').text();
+```
+
+The client is callable on purpose. Like jQuery, the common case starts with one small
+function and becomes more specific through chaining:
+
+```ts
+const result = await ai('Create a release note from these commits')
+  .system('You are a concise technical writer.')
+  .temperature(0.2)
+  .maxOutputTokens(500)
+  .text();
+```
+
+Builders are immutable, so a configured base request can be safely reused.
+
+## Chaining prompts
+
+A chain remembers successful user and assistant turns. Each new prompt sees the complete
+history:
+
+```ts
+import { system } from 'genaicode';
+
+const chain = ai.chain(system('You are helping refine an API design.'));
+
+const answer1 = await chain.text('Prompt 1: propose a minimal endpoint.');
+const answer2 = await chain.text('Prompt 2: add idempotency to that design.');
+const answer3 = await chain.text('Prompt 3: summarize the final contract.');
 ```
 
-This will start the GenAIcode web server and open the browser with the UI.
-
-Here is how it looks like:
-
-<img width="1284" alt="image" src="https://github.com/user-attachments/assets/82fae142-f2df-43c9-871a-50e526f37c83" />
-
-## CLI Features
-
-GenAIcode supports various command-line options to customize its behavior:
-
-- `--ai-service=<ai service>`: Pick an ai service/model that will be used for code generation
-- `--ui`: Run the tool as a web server, and use it via browser
-- `--ui-port=<port>`: Specify the port for the web server when using --ui (default: 1337)
-- `--interactive`: Run the tool in interactive mode
-- `--dry-run`: Runs the tool without making any changes to the files.
-- `--disallow-file-create`: Disallows the tool to create new files (file creation is allowed by default).
-- `--disallow-file-delete`: Disallows the tool to delete files (file deletion is allowed by default).
-- `--disallow-directory-create`: Disallows the tool to create directories (directory creation is allowed by default).
-- `--disallow-file-move`: Disallows the tool to move files within the project structure (file moving is allowed by default).
-- `--explicit-prompt=<prompt>`: Provides an explicit prompt for code generation.
-- `--task-file=<file>`: Specifies a file with a task description for code generation.
-- `--verbose-prompt`: Prints the prompt used for code generation.
-- `--disable-explanations`: Disables explanations for code generation operations. By default, explanations are enabled, as it improves response quality.
-- `--disable-context-optimization`: Disables the optimization that uses context paths for more efficient code generation.
-- `--gemini-block-none`: Disables safety settings for Gemini Pro model (requires whitelisted Cloud project).
-- `--temperature=<value>`: Sets the temperature parameter for the AI model (default: 0.7).
-- `--vision`: Enables vision capabilities for processing image inputs.
-- `--imagen`: Enables image generation capabilities using AI models.
-- `--cheap`: Uses a cheaper, faster model for code generation, which may provide lower quality results but is more cost-effective for simpler tasks.
-- `--content-mask=<path>`: Applies a content mask to limit the initial source code files included in the request. The value should be a prefix of the path relative to rootDir.
-- `--ignore-pattern="glob/regex"`: Specify a pattern of files to ignore during the initial source code fetching. This saves initial token usage.
-- `--disable-ask-question`: Disable the default behavior of AI assistant to ask questions for clarification during the code generation process.
-- `--disable-cache`: Disables caching for the application, which can be useful if caching is causing issues or if you want to ensure fresh data is used for each operation.
-- `--help`: Displays the help message with all available options.
-
-## Configuration (.genaicoderc)
-
-The `.genaicoderc`(or `genaicode.config.ts` + js/mts etc.) file allows you to configure various aspects of GenAIcode's behavior. Here are the available options:
-
-```json
-{
-  "rootDir": ".",
-  "extensions": [".md", ".js", ".ts", ".tsx", ".css"],
-  "ignorePaths": ["node_modules", "build", "dist", "package-lock.json", "coverage"],
-  "lintCommand": "npm run lint",
-  "plugins": ["plugins/custom_tools.ts"],
-  "importantContext": {
-    "systemPrompt": ["IMPORTANT: Always use typescript"],
-    "files": ["code_style.md"]
+This is `prompt1 → response1 → prompt2 → response2 → prompt3 → response3`. The history
+is available as portable `PromptItem[]` through `chain.history()`.
+
+## Using a chain in a loop
+
+A chain is ordinary application state, so normal control flow works:
+
+```ts
+const chain = ai.chain(system('Improve the draft while preserving its meaning.'));
+let draft = 'The deployment had a problem and we fixed it.';
+
+for (const instruction of ['Make it specific.', 'Make it concise.', 'Use a professional tone.']) {
+  draft = await chain.text(`${instruction}\n\nCurrent draft:\n${draft}`);
+}
+```
+
+Calls on one chain are serialized, even if application code starts them concurrently.
+Failed provider calls are not added to history.
+
+Validation and repair are also plain loops rather than a special agent abstraction:
+
+```ts
+import { parseJsonResult, resultText, system } from 'genaicode';
+
+const repair = ai.chain(system('Return only valid JSON with a non-negative count.'));
+let count: number | undefined;
+
+for (let attempt = 1; attempt <= 3; attempt += 1) {
+  const result = await repair.ask(
+    attempt === 1 ? 'Count the actionable items in this text: ...' : 'Correct the previous response.',
+  );
+
+  try {
+    const value = parseJsonResult<{ count: number }>(result);
+    if (value.count < 0) throw new Error('count must be non-negative');
+    count = value.count;
+    break;
+  } catch (error) {
+    if (attempt === 3) throw error;
+    console.warn('Invalid model response:', resultText(result));
   }
 }
 ```
 
-- `rootDir`: Specifies the root directory of your project (required).
-- `extensions`: An array of file extensions to be considered by the tool (optional, defaults to a predefined list).
-- `ignorePaths`: An array of paths to be ignored by the tool (optional).
-- `lintCommand`: Specifies a lint command to be run before and after code generation (optional).
-- `modelOverrides`: Allows overriding the default AI models used for each service (optional).
-- `plugins`: Specify plugins to be loaded (see [example plugins](./examples/genaicode_plugins/))
-- `importantContext`: Add your custom instructions to the `systemPrompt`. Force specific `files` to be always included in the context
+The application owns validation, attempt limits, and failure policy.
 
-## Usage
+## PromptItem: the portable prompt IR
 
-To use GenAIcode, run the command with your desired options:
+`PromptItem` is GenAIcode's provider-neutral intermediate representation:
 
-```bash
-npx genaicode [options]
+```ts
+import { image, prompt, system, toolResults, user } from 'genaicode';
+
+const items = prompt(
+  system('Return a one-sentence caption.'),
+  user('Describe this image.', {
+    images: [image(base64Png, 'image/png')],
+  }),
+  toolResults({
+    callId: 'lookup-1',
+    name: 'lookup',
+    content: JSON.stringify({ locale: 'pl-PL' }),
+  }),
+);
+
+const caption = await ai(items).text();
 ```
 
-For example:
+Applications can make domain objects prompt-aware without coupling them to a provider:
 
-```bash
-npx genaicode --explicit-prompt="Add a new utility function for string manipulation"
+```ts
+import { asPrompt, system, user } from 'genaicode';
+
+const supportTicket = (ticket: Ticket) =>
+  asPrompt(() => [system('Triage support tickets.'), user(JSON.stringify(ticket))]);
+
+await ai(supportTicket(ticket)).text();
 ```
 
-To run GenAIcode with the web UI on a specific port:
+## Tools
+
+```ts
+const calls = await ai('What is the weather in Warsaw?')
+  .tools([
+    {
+      name: 'weather',
+      description: 'Get current weather',
+      parameters: {
+        type: 'object',
+        properties: { city: { type: 'string' } },
+        required: ['city'],
+        additionalProperties: false,
+      },
+    },
+  ])
+  .toolCalls();
+```
 
-```bash
-npx genaicode --ui --ui-port=8080
+GenAIcode normalizes tool calls but deliberately does not execute them. The application
+owns permissions, retries, and side effects.
+
+## Providers
+
+Models are provided in the adapter, through `.model(...)`, or with environment variables:
+
+| Adapter                | Factory              | Environment defaults                                               |
+| ---------------------- | -------------------- | ------------------------------------------------------------------ |
+| OpenAI                 | `openai()`           | `OPENAI_API_KEY`, `OPENAI_MODEL`                                   |
+| Anthropic              | `anthropic()`        | `ANTHROPIC_API_KEY`, `ANTHROPIC_MODEL`                             |
+| Gemini API / AI Studio | `gemini()`           | `GEMINI_API_KEY` or `API_KEY`, `GEMINI_MODEL`                      |
+| Vertex AI              | `vertexAI()`         | `GOOGLE_CLOUD_PROJECT`, `GOOGLE_CLOUD_LOCATION`, `VERTEX_AI_MODEL` |
+| OpenAI-compatible      | `openaiCompatible()` | Explicit options; OpenAI defaults also work                        |
+
+```ts
+import { anthropic, gemini, openai, vertexAI } from 'genaicode/providers';
+
+const viaOpenAI = genaicode(openai({ model: 'your-openai-model' }));
+const viaClaude = genaicode(anthropic({ model: 'your-claude-model' }));
+const viaGemini = genaicode(gemini({ model: 'your-gemini-model' }));
+const viaVertex = genaicode(
+  vertexAI({
+    project: 'my-google-cloud-project',
+    location: 'global',
+    model: 'your-vertex-model',
+  }),
+);
+```
+
+Provider-specific options stay at provider construction. For example, Anthropic exposes
+thinking and output-token defaults, while Gemini and Vertex expose SDK HTTP, auth, API
+version, and generation configuration options.
+
+GitHub Models, Ollama, vLLM, and other compatible gateways use the OpenAI-compatible
+adapter:
+
+```ts
+import { openaiCompatible } from 'genaicode/providers';
+
+const local = genaicode(
+  openaiCompatible({
+    name: 'local',
+    baseURL: 'http://localhost:11434/v1',
+    apiKey: 'local',
+    model: 'qwen3',
+  }),
+);
 ```
 
-This will start the web server on port 8080 instead of the default 1337.
+Implementing a provider directly is intentionally small:
+
+```ts
+import type { ModelProvider } from 'genaicode';
+
+const provider: ModelProvider = {
+  name: 'internal-gateway',
+  async generate(request) {
+    // Convert request.prompt to your API and normalize the response.
+    return { parts: [{ type: 'text', text: 'response' }] };
+  },
+};
+```
 
-## Examples
+All Anthropic, Google, and OpenAI conversion functions are public from
+`genaicode/providers`, so gateways and tests can reuse them without instantiating clients.
 
-For practical examples of using GenAIcode, visit our [Examples](examples/README.md) page.
+## Plugins and hooks
+
+A provider plugin no longer needs registration in global configuration. It exports the
+same small `ModelProvider` contract as a built-in adapter:
+
+```ts
+// @acme/genaicode-bedrock
+import type { ModelProvider } from 'genaicode';
+
+export const bedrock = (options: BedrockOptions): ModelProvider => ({
+  name: 'bedrock',
+  async generate(request) {
+    // Convert PromptItem[], call Bedrock, and return GenerationResult.
+    return { parts: [{ type: 'text', text: 'response' }] };
+  },
+});
+```
+
+Hook-style plugins use middleware. They can observe or rewrite requests and results,
+handle errors, implement caches or fallbacks, and intentionally short-circuit a call:
+
+```ts
+import { definePlugin, genaicode } from 'genaicode';
+import { openai } from 'genaicode/providers';
+
+const timing = definePlugin({
+  name: 'timing',
+  async generate(request, next) {
+    const startedAt = performance.now();
+    try {
+      return await next(request);
+    } finally {
+      console.log('LLM request took', performance.now() - startedAt, 'ms');
+    }
+  },
+});
+
+const ai = genaicode(openai({ model: 'your-model-name' }), {
+  plugins: [timing],
+});
+```
 
-## More Information
+Plugins run in registration order, and each plugin may call `next()` once. This keeps the
+extension mechanism compatible with npm packages and ordinary imports without restoring
+the 1.x runtime TypeScript loader or process-global plugin registry.
 
-For in-depth details about GenAIcode's features, supported AI models, file operations, and advanced usage, please refer to our comprehensive [Design Document](docs/design/genaicode_design_doc.md).
+## Design boundaries
 
-## Feedback and Contributions
+- Backend library, not a coding agent.
+- Provider-neutral core with no global configuration.
+- Explicit models and credentials; environment variables are only provider defaults.
+- Immutable request builders.
+- Conversation history is explicit; loops remain ordinary application code.
+- No hidden tool execution or hidden retries.
+- Third-party providers and middleware use stable TypeScript contracts.
+- Provider SDKs stay behind the `genaicode/providers` subpath.
 
-We welcome your feedback and contributions! Please feel free to open issues or submit pull requests on our GitHub repository.
+See [the pivot plan](docs/pivot.md) for product scope, migration decisions, and the roadmap.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { pivotNotice } from './pivot-notice.js';
+process.stdout.write(`${pivotNotice}\n`);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,CAAC,CAAC"}

package/dist/core/client.d.ts

@@ -0,0 +1,36 @@
+import { type GenAIPlugin } from './plugins.js';
+import type { GenerationDefaults, GenerationRequest, GenerationResult, ModelProvider, PromptInput, PromptItem, ToolCall, ToolChoice, ToolDefinition } from './types.js';
+export interface RequestBuilder {
+    system(text: string): RequestBuilder;
+    user(input: PromptInput): RequestBuilder;
+    assistant(text: string, toolCalls?: ToolCall[]): RequestBuilder;
+    model(model: string): RequestBuilder;
+    temperature(temperature: number): RequestBuilder;
+    maxOutputTokens(maxOutputTokens: number): RequestBuilder;
+    tools(tools: ToolDefinition[], choice?: ToolChoice): RequestBuilder;
+    signal(signal: AbortSignal): RequestBuilder;
+    run(): Promise<GenerationResult>;
+    text(): Promise<string>;
+    json<T = unknown>(parse?: (value: unknown) => T): Promise<T>;
+    toolCalls(): Promise<ToolCall[]>;
+    inspect(): GenerationRequest;
+}
+export type ConfigureRequest = (request: RequestBuilder) => RequestBuilder;
+export interface Conversation {
+    ask(input: PromptInput, configure?: ConfigureRequest): Promise<GenerationResult>;
+    text(input: PromptInput, configure?: ConfigureRequest): Promise<string>;
+    json<T = unknown>(input: PromptInput, parse?: (value: unknown) => T, configure?: ConfigureRequest): Promise<T>;
+    toolCalls(input: PromptInput, configure?: ConfigureRequest): Promise<ToolCall[]>;
+    history(): PromptItem[];
+    reset(...initial: PromptInput[]): void;
+}
+export interface GenAIClient {
+    (input: PromptInput): RequestBuilder;
+    prompt(...inputs: PromptInput[]): RequestBuilder;
+    chain(...initial: PromptInput[]): Conversation;
+    readonly provider: ModelProvider;
+}
+export interface GenAIClientOptions extends GenerationDefaults {
+    plugins?: readonly GenAIPlugin[];
+}
+export declare function genaicode(provider: ModelProvider, options?: GenAIClientOptions): GenAIClient;

package/dist/core/client.js

@@ -0,0 +1,121 @@
+import { assistant, prompt, system, toPromptItems } from './prompt.js';
+import { withPlugins } from './plugins.js';
+import { parseJsonResult, resultText, resultToPromptItem, resultToolCalls } from './result.js';
+class RequestBuilderImpl {
+    provider;
+    state;
+    constructor(provider, state) {
+        this.provider = provider;
+        this.state = state;
+    }
+    copy(change) {
+        return new RequestBuilderImpl(this.provider, {
+            ...this.state,
+            ...change,
+            prompt: change.prompt ?? this.state.prompt,
+        });
+    }
+    system(text) {
+        const nextPrompt = [...this.state.prompt];
+        const firstNonSystem = nextPrompt.findIndex((item) => item.type !== 'systemPrompt');
+        nextPrompt.splice(firstNonSystem === -1 ? nextPrompt.length : firstNonSystem, 0, system(text));
+        return this.copy({ prompt: nextPrompt });
+    }
+    user(input) {
+        return this.copy({ prompt: [...this.state.prompt, ...toPromptItems(input)] });
+    }
+    assistant(text, toolCalls = []) {
+        return this.copy({ prompt: [...this.state.prompt, assistant(text, { toolCalls })] });
+    }
+    model(model) {
+        return this.copy({ model });
+    }
+    temperature(temperature) {
+        return this.copy({ temperature });
+    }
+    maxOutputTokens(maxOutputTokens) {
+        return this.copy({ maxOutputTokens });
+    }
+    tools(tools, toolChoice = 'auto') {
+        return this.copy({ tools, toolChoice });
+    }
+    signal(signal) {
+        return this.copy({ signal });
+    }
+    inspect() {
+        return {
+            prompt: this.state.prompt.map((item) => ({ ...item })),
+            model: this.state.model,
+            temperature: this.state.temperature,
+            maxOutputTokens: this.state.maxOutputTokens,
+            tools: this.state.tools,
+            toolChoice: this.state.toolChoice,
+            signal: this.state.signal,
+            metadata: this.state.metadata,
+        };
+    }
+    run() {
+        return this.provider.generate(this.inspect());
+    }
+    async text() {
+        return resultText(await this.run());
+    }
+    async json(parse) {
+        const result = await this.run();
+        return parseJsonResult(result, parse);
+    }
+    async toolCalls() {
+        return resultToolCalls(await this.run());
+    }
+}
+class ConversationImpl {
+    createRequest;
+    items;
+    queue = Promise.resolve();
+    generation = 0;
+    constructor(initial, createRequest) {
+        this.createRequest = createRequest;
+        this.items = initial;
+    }
+    ask(input, configure = (request) => request) {
+        const execute = async () => {
+            const additions = toPromptItems(input);
+            const generation = this.generation;
+            const result = await configure(this.createRequest(this.items, additions)).run();
+            if (generation === this.generation) {
+                this.items = [...this.items, ...additions, resultToPromptItem(result)];
+            }
+            return result;
+        };
+        const operation = this.queue.then(execute);
+        this.queue = operation.then(() => undefined, () => undefined);
+        return operation;
+    }
+    async text(input, configure) {
+        return resultText(await this.ask(input, configure));
+    }
+    async json(input, parse, configure) {
+        return parseJsonResult(await this.ask(input, configure), parse);
+    }
+    async toolCalls(input, configure) {
+        return resultToolCalls(await this.ask(input, configure));
+    }
+    history() {
+        return this.items.map((item) => ({ ...item }));
+    }
+    reset(...initial) {
+        this.generation += 1;
+        this.items = prompt(...initial);
+    }
+}
+export function genaicode(provider, options = {}) {
+    const { plugins = [], ...defaults } = options;
+    const effectiveProvider = withPlugins(provider, plugins);
+    const createRequest = (...inputs) => new RequestBuilderImpl(effectiveProvider, { ...defaults, prompt: prompt(...inputs) });
+    return Object.assign((input) => createRequest(input), {
+        prompt: createRequest,
+        chain: (...initial) => new ConversationImpl(prompt(...initial), createRequest),
+        provider: effectiveProvider,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

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

package/dist/core/plugins.d.ts

@@ -0,0 +1,14 @@
+import type { GenerationRequest, GenerationResult, ModelProvider } from './types.js';
+export type GenerateNext = (request?: GenerationRequest) => Promise<GenerationResult>;
+export interface GenAIPlugin {
+    readonly name: string;
+    generate(request: GenerationRequest, next: GenerateNext): Promise<GenerationResult>;
+}
+export declare function definePlugin(plugin: GenAIPlugin): GenAIPlugin;
+/**
+ * Wrap a provider with middleware-style plugins.
+ *
+ * Plugins run in registration order. Each plugin may modify the request passed
+ * to `next`, transform its result, handle an error, or intentionally short-circuit.
+ */
+export declare function withPlugins(provider: ModelProvider, plugins: readonly GenAIPlugin[]): ModelProvider;

package/dist/core/plugins.js

@@ -0,0 +1,31 @@
+export function definePlugin(plugin) {
+    return plugin;
+}
+/**
+ * Wrap a provider with middleware-style plugins.
+ *
+ * Plugins run in registration order. Each plugin may modify the request passed
+ * to `next`, transform its result, handle an error, or intentionally short-circuit.
+ */
+export function withPlugins(provider, plugins) {
+    if (plugins.length === 0)
+        return provider;
+    return {
+        name: provider.name,
+        generate(request) {
+            let lastIndex = -1;
+            const dispatch = (index, currentRequest) => {
+                if (index <= lastIndex) {
+                    return Promise.reject(new Error('A GenAIcode plugin called next() more than once.'));
+                }
+                lastIndex = index;
+                const plugin = plugins[index];
+                if (!plugin)
+                    return provider.generate(currentRequest);
+                return plugin.generate(currentRequest, (nextRequest = currentRequest) => dispatch(index + 1, nextRequest));
+            };
+            return dispatch(0, request);
+        },
+    };
+}
+//# sourceMappingURL=plugins.js.map

package/dist/core/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/core/plugins.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAuB,EAAE,OAA+B;IAClF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,CAAC,OAAO;YACd,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,cAAiC,EAA6B,EAAE;gBAC/F,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;oBACvB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,CAAC;gBACvF,CAAC;gBACD,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC9B,IAAI,CAAC,MAAM;oBAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;gBACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,WAAW,GAAG,cAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YAC7G,CAAC,CAAC;YACF,OAAO,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/prompt.d.ts

@@ -0,0 +1,14 @@
+import type { PromptConvertible, PromptImage, PromptInput, PromptItem, ToolCall, ToolResult } from './types.js';
+export declare function toPromptItems(input: PromptInput): PromptItem[];
+export declare function prompt(...inputs: PromptInput[]): PromptItem[];
+export declare function system(text: string): PromptItem;
+export declare function user(text: string, options?: {
+    images?: PromptImage[];
+    toolResults?: ToolResult[];
+}): PromptItem;
+export declare function assistant(text: string, options?: {
+    toolCalls?: ToolCall[];
+}): PromptItem;
+export declare function toolResults(...results: ToolResult[]): PromptItem;
+export declare function image(dataOrUrl: string, mediaType: PromptImage['mediaType']): PromptImage;
+export declare function asPrompt(convert: () => PromptItem | readonly PromptItem[]): PromptConvertible;