@vesk/agentic 0.2.11

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @vesk/agentic — Vesk agentic plugin
+ *
+ * Zero-deps agent loop, provider abstraction, permissions, tools, checkpoints.
+ * Installable plugin — core Vesk ships with zero AI deps.
+ * @module agentic
+ */
+export { default } from './plugin.js';
+export { default as agenticPlugin } from './plugin.js';
+export type { AgenticOptions } from './plugin.js';
+export { Agent, MaxStepsExceededError, defineTool } from './loop.js';
+export type { AgentOptions, AgentResult, Provider, Tool, ToolCall, CompletionRequest, CompletionResponse } from './loop.js';
+export { openAiProvider } from './providers/openai.js';
+export { anthropicProvider } from './providers/anthropic.js';
+export { googleProvider } from './providers/google.js';
+export { ollamaProvider } from './providers/ollama.js';
+export type { ProviderConfig, ProviderName } from './providers/types.js';
+export { AgentCapabilityTable, DEFAULT_PERMISSIONS, filterToolsByPermissions, isToolAllowed } from './permissions.js';
+export type { AgentMode, AgentCapability } from './permissions.js';
+export { loadFrameworkKnowledge, loadProjectKnowledge, assembleSystemPrompt } from './context.js';
+export { CheckpointManager } from './checkpoints.js';
+export type { Checkpoint } from './checkpoints.js';
+export { createAgentRouter } from './dev-api.js';
+export type { AgentRouter, AgentRouterOptions } from './dev-api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG5H,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtH,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @vesk/agentic — Vesk agentic plugin
+ *
+ * Zero-deps agent loop, provider abstraction, permissions, tools, checkpoints.
+ * Installable plugin — core Vesk ships with zero AI deps.
+ * @module agentic
+ */
+export { default } from './plugin.js';
+export { default as agenticPlugin } from './plugin.js';
+// Core loop (vendored @narimangardi/agent-loop)
+export { Agent, MaxStepsExceededError, defineTool } from './loop.js';
+// Providers (fetch-only, zero SDKs)
+export { openAiProvider } from './providers/openai.js';
+export { anthropicProvider } from './providers/anthropic.js';
+export { googleProvider } from './providers/google.js';
+export { ollamaProvider } from './providers/ollama.js';
+// Permissions
+export { AgentCapabilityTable, DEFAULT_PERMISSIONS, filterToolsByPermissions, isToolAllowed } from './permissions.js';
+// Context & checkpoints
+export { loadFrameworkKnowledge, loadProjectKnowledge, assembleSystemPrompt } from './context.js';
+export { CheckpointManager } from './checkpoints.js';
+// Dev API
+export { createAgentRouter } from './dev-api.js';

package/dist/loop.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @vesk/agentic — zero-deps agent loop
+ *
+ * Cloned from @narimangardi/agent-loop@0.3.0 (MIT, 20.7kB, zero deps).
+ * MIT-compatible: credit to Nariman Gardi. Vesk owns this copy so
+ * @vesk/agentic stays dependency-free and not tied to external publish.
+ *
+ * The whole thing is one class: ask LLM, run tools, feed results back,
+ * repeat until answer or maxSteps. Bring your own Provider (fetch-only).
+ */
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export type Message = {
+    role: 'system';
+    content: string;
+} | {
+    role: 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string | null;
+    toolCalls?: ToolCall[];
+} | {
+    role: 'tool';
+    toolCallId: string;
+    name: string;
+    content: string;
+};
+export interface Tool<A extends Record<string, unknown> = Record<string, unknown>> {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute(args: A): string | Promise<string>;
+}
+export interface ToolSpec {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface CompletionRequest {
+    messages: Message[];
+    tools: ToolSpec[];
+}
+export type CompletionResponse = {
+    kind: 'message';
+    content: string;
+} | {
+    kind: 'tool_calls';
+    toolCalls: ToolCall[];
+};
+/** Provider-level streaming event (one per `completeStream` invocation). */
+export type StreamEvent = {
+    kind: 'delta';
+    content: string;
+} | {
+    kind: 'message';
+    content: string;
+} | {
+    kind: 'tool_calls';
+    toolCalls: ToolCall[];
+};
+export interface Provider {
+    complete(request: CompletionRequest): Promise<CompletionResponse>;
+    completeStream?(request: CompletionRequest): AsyncIterable<StreamEvent>;
+    listModels?(options: {
+        apiKey?: string;
+        baseUrl?: string;
+    }): Promise<string[]>;
+}
+export interface AgentOptions {
+    provider: Provider;
+    tools?: Tool[];
+    system?: string;
+    /** Soft step budget. The agent finishes as soon as the model returns a plain
+        message; once `step` passes this budget without a final message it either
+        throws `MaxStepsExceededError` (when `autoExtend` is false) or keeps going
+        (when `autoExtend` is true). Default 10. */
+    maxSteps?: number;
+    /** When true, tool-calling steps beyond `maxSteps` are allowed to continue up
+        to `hardMaxSteps` instead of stopping, so multi-step tasks aren't cut off
+        prematurely while progress is being made. Default false. */
+    autoExtend?: boolean;
+    /** Absolute step ceiling used when `autoExtend` is true. Defaults to
+        `max(maxSteps * 4, maxSteps + 20)`. */
+    hardMaxSteps?: number;
+    onStep?: (step: number) => void | Promise<void>;
+    onToolCall?: (call: ToolCall) => void | Promise<void>;
+    onToolResult?: (call: ToolCall, output: string) => void | Promise<void>;
+}
+/** Agent-level streaming event (`runStream`). */
+export type AgentStreamEvent = {
+    type: 'user';
+    content: string;
+} | {
+    type: 'step';
+    step: number;
+    budget: number;
+} | {
+    type: 'assistant_start';
+    step: number;
+} | {
+    type: 'text_delta';
+    content: string;
+} | {
+    type: 'assistant_end';
+    step: number;
+    content: string;
+} | {
+    type: 'tool_call';
+    step: number;
+    call: ToolCall;
+} | {
+    type: 'tool_result';
+    step: number;
+    call: ToolCall;
+    output: string;
+} | {
+    type: 'done';
+    result: AgentResult;
+} | {
+    type: 'error';
+    message: string;
+};
+export interface AgentResult {
+    text: string;
+    steps: number;
+    messages: Message[];
+}
+export declare class MaxStepsExceededError extends Error {
+    readonly steps: number;
+    readonly messages: Message[];
+    constructor(steps: number, messages: Message[]);
+}
+export declare function defineTool<A extends Record<string, unknown> = Record<string, unknown>>(tool: Tool<A>): Tool<A>;
+export declare class Agent {
+    private readonly provider;
+    private readonly tools;
+    private readonly toolSpecs;
+    private readonly system?;
+    private readonly maxSteps;
+    private readonly stepBudget;
+    private readonly onStep?;
+    private readonly onToolCall?;
+    private readonly onToolResult?;
+    constructor(options: AgentOptions);
+    run(prompt: string): Promise<AgentResult>;
+    /** Stream the agent run. Mirrors `run()` but yields progress events, including
+        text deltas as the model generates them (via `provider.completeStream` when
+        available; otherwise the final message is emitted as a single delta). */
+    runStream(prompt: string): AsyncGenerator<AgentStreamEvent>;
+    private runTool;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

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

package/dist/loop.js

@@ -0,0 +1,178 @@
+/**
+ * @vesk/agentic — zero-deps agent loop
+ *
+ * Cloned from @narimangardi/agent-loop@0.3.0 (MIT, 20.7kB, zero deps).
+ * MIT-compatible: credit to Nariman Gardi. Vesk owns this copy so
+ * @vesk/agentic stays dependency-free and not tied to external publish.
+ *
+ * The whole thing is one class: ask LLM, run tools, feed results back,
+ * repeat until answer or maxSteps. Bring your own Provider (fetch-only).
+ */
+export class MaxStepsExceededError extends Error {
+    steps;
+    messages;
+    constructor(steps, messages) {
+        super(`Agent did not finish within ${steps} steps`);
+        this.steps = steps;
+        this.messages = messages;
+        this.name = 'MaxStepsExceededError';
+    }
+}
+export function defineTool(tool) {
+    return tool;
+}
+// ──────────────────────────────────────────────────────────────────────────────
+// Agent
+// ──────────────────────────────────────────────────────────────────────────────
+export class Agent {
+    provider;
+    tools;
+    toolSpecs;
+    system;
+    maxSteps;
+    stepBudget;
+    onStep;
+    onToolCall;
+    onToolResult;
+    constructor(options) {
+        const tools = options.tools ?? [];
+        this.provider = options.provider;
+        this.tools = new Map(tools.map((t) => [t.name, t]));
+        this.toolSpecs = tools.map(({ name, description, parameters }) => ({ name, description, parameters }));
+        this.system = options.system;
+        const softMax = Math.max(1, Math.floor(options.maxSteps ?? 10));
+        this.maxSteps = softMax;
+        if (options.autoExtend) {
+            const hard = options.hardMaxSteps === undefined ? Math.max(softMax * 4, softMax + 20) : Math.max(softMax, Math.floor(options.hardMaxSteps));
+            this.stepBudget = Math.min(hard, 10000);
+        }
+        else {
+            this.stepBudget = softMax;
+        }
+        this.onStep = options.onStep;
+        this.onToolCall = options.onToolCall;
+        this.onToolResult = options.onToolResult;
+    }
+    async run(prompt) {
+        const messages = [];
+        if (this.system !== undefined)
+            messages.push({ role: 'system', content: this.system });
+        messages.push({ role: 'user', content: prompt });
+        for (let step = 1; step <= this.stepBudget; step++) {
+            await this.onStep?.(step);
+            const response = await this.provider.complete({ messages, tools: this.toolSpecs });
+            if (response.kind === 'message') {
+                messages.push({ role: 'assistant', content: response.content });
+                return { text: response.content, steps: step, messages };
+            }
+            messages.push({ role: 'assistant', content: null, toolCalls: response.toolCalls });
+            const results = await Promise.all(response.toolCalls.map(async (call) => {
+                await this.onToolCall?.(call);
+                return { call, output: await this.runTool(call) };
+            }));
+            for (const { call, output } of results) {
+                await this.onToolResult?.(call, output);
+                messages.push({ role: 'tool', toolCallId: call.id, name: call.name, content: output });
+            }
+        }
+        throw new MaxStepsExceededError(this.stepBudget, messages);
+    }
+    /** Stream the agent run. Mirrors `run()` but yields progress events, including
+        text deltas as the model generates them (via `provider.completeStream` when
+        available; otherwise the final message is emitted as a single delta). */
+    async *runStream(prompt) {
+        const messages = [];
+        if (this.system !== undefined)
+            messages.push({ role: 'system', content: this.system });
+        messages.push({ role: 'user', content: prompt });
+        yield { type: 'user', content: prompt };
+        for (let step = 1; step <= this.stepBudget; step++) {
+            yield { type: 'step', step, budget: this.stepBudget };
+            await this.onStep?.(step);
+            if (this.provider.completeStream) {
+                yield { type: 'assistant_start', step };
+                let content = '';
+                let term = { kind: 'message', content: '' };
+                try {
+                    for await (const ev of this.provider.completeStream({ messages, tools: this.toolSpecs })) {
+                        if (ev.kind === 'delta') {
+                            content += ev.content;
+                            yield { type: 'text_delta', content: ev.content };
+                        }
+                        else {
+                            term = ev;
+                        }
+                    }
+                }
+                catch (e) {
+                    yield { type: 'error', message: e instanceof Error ? e.message : String(e) };
+                    return;
+                }
+                if (term.kind === 'message') {
+                    messages.push({ role: 'assistant', content });
+                    yield { type: 'assistant_end', step, content };
+                    yield { type: 'done', result: { text: content, steps: step, messages } };
+                    return;
+                }
+                const toolCalls = term.toolCalls ?? [];
+                if (toolCalls.length === 0) {
+                    messages.push({ role: 'assistant', content });
+                    yield { type: 'assistant_end', step, content };
+                    yield { type: 'done', result: { text: content, steps: step, messages } };
+                    return;
+                }
+                messages.push({ role: 'assistant', content: null, toolCalls });
+                const results = await Promise.all(toolCalls.map(async (call) => {
+                    await this.onToolCall?.(call);
+                    return { call, output: await this.runTool(call) };
+                }));
+                for (const { call, output } of results) {
+                    await this.onToolResult?.(call, output);
+                    yield { type: 'tool_call', step, call };
+                    yield { type: 'tool_result', step, call, output };
+                    messages.push({ role: 'tool', toolCallId: call.id, name: call.name, content: output });
+                }
+                continue;
+            }
+            let response;
+            try {
+                response = await this.provider.complete({ messages, tools: this.toolSpecs });
+            }
+            catch (e) {
+                yield { type: 'error', message: e instanceof Error ? e.message : String(e) };
+                return;
+            }
+            if (response.kind === 'message') {
+                yield { type: 'assistant_start', step };
+                yield { type: 'text_delta', content: response.content };
+                messages.push({ role: 'assistant', content: response.content });
+                yield { type: 'assistant_end', step, content: response.content };
+                yield { type: 'done', result: { text: response.content, steps: step, messages } };
+                return;
+            }
+            messages.push({ role: 'assistant', content: null, toolCalls: response.toolCalls });
+            const results = await Promise.all(response.toolCalls.map(async (call) => {
+                await this.onToolCall?.(call);
+                return { call, output: await this.runTool(call) };
+            }));
+            for (const { call, output } of results) {
+                await this.onToolResult?.(call, output);
+                yield { type: 'tool_call', step, call };
+                yield { type: 'tool_result', step, call, output };
+                messages.push({ role: 'tool', toolCallId: call.id, name: call.name, content: output });
+            }
+        }
+        yield { type: 'error', message: `Agent did not finish within ${this.stepBudget} steps` };
+    }
+    async runTool(call) {
+        const tool = this.tools.get(call.name);
+        if (tool === undefined)
+            return `Error: unknown tool "${call.name}"`;
+        try {
+            return await tool.execute(call.arguments);
+        }
+        catch (e) {
+            return `Error: ${e instanceof Error ? e.message : String(e)}`;
+        }
+    }
+}

package/dist/permissions.d.ts

@@ -0,0 +1,14 @@
+import type { Tool } from './loop.js';
+export type AgentMode = 'explore' | 'debug' | 'agent';
+export type AgentCapability = 'readFiles' | 'writeFiles' | 'deleteFiles' | 'executeCommands' | 'installPackages' | 'modifyConfig' | 'managePlugins' | 'runBuild' | 'runTests' | 'modifyAgentsMd' | 'createCheckpoint' | 'rollback';
+export declare const DEFAULT_PERMISSIONS: Record<AgentMode, Set<AgentCapability>>;
+export declare class AgentCapabilityTable {
+    readonly mode: AgentMode;
+    private caps;
+    constructor(mode: AgentMode, overrides?: Partial<Record<AgentCapability, boolean>>);
+    allows(cap: AgentCapability): boolean;
+    isToolAllowed(toolName: string): boolean;
+}
+export declare function filterToolsByPermissions(tools: Tool[], table: AgentCapabilityTable): Tool[];
+export declare function isToolAllowed(toolName: string, table: AgentCapabilityTable): boolean;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,kBAAkB,GAClB,UAAU,CAAC;AAmBf,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,eAAe,CAAC,CAIvE,CAAC;AAwBF,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,IAAI,CAAuB;gBAEvB,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAYlF,MAAM,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO;IAIrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAKzC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAAE,CAE3F;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAEpF"}

package/dist/permissions.js

@@ -0,0 +1,74 @@
+const EXPLORE_CAPS = new Set(['readFiles']);
+const DEBUG_CAPS = new Set(['readFiles', 'writeFiles', 'runBuild', 'runTests', 'createCheckpoint']);
+const AGENT_CAPS = new Set([
+    'readFiles',
+    'writeFiles',
+    'deleteFiles',
+    'executeCommands',
+    'installPackages',
+    'modifyConfig',
+    'managePlugins',
+    'runBuild',
+    'runTests',
+    'modifyAgentsMd',
+    'createCheckpoint',
+    'rollback',
+]);
+export const DEFAULT_PERMISSIONS = {
+    explore: EXPLORE_CAPS,
+    debug: DEBUG_CAPS,
+    agent: AGENT_CAPS,
+};
+// Tool -> capability map (server-enforced)
+const TOOL_CAP = {
+    'vesk.inspectProject': 'readFiles',
+    'vesk.inspectComponent': 'readFiles',
+    'vesk.readConfig': 'readFiles',
+    'vesk.updateConfig': 'modifyConfig',
+    'vesk.getDiagnostics': 'readFiles',
+    'vesk.getCompilerErrors': 'readFiles',
+    'vesk.runBuild': 'runBuild',
+    'vesk.runTests': 'runTests',
+    'vesk.installPlugin': 'installPackages',
+    'vesk.uninstallPlugin': 'installPackages',
+    'vesk.enablePlugin': 'managePlugins',
+    'vesk.disablePlugin': 'managePlugins',
+    'vesk.createCheckpoint': 'createCheckpoint',
+    'vesk.rollback': 'rollback',
+    'filesystem.read': 'readFiles',
+    'filesystem.write': 'writeFiles',
+    'filesystem.delete': 'deleteFiles',
+    'command.execute': 'executeCommands',
+};
+export class AgentCapabilityTable {
+    mode;
+    caps;
+    constructor(mode, overrides) {
+        this.mode = mode;
+        const base = new Set(DEFAULT_PERMISSIONS[mode]);
+        if (overrides) {
+            for (const [k, v] of Object.entries(overrides)) {
+                if (v)
+                    base.add(k);
+                else
+                    base.delete(k);
+            }
+        }
+        this.caps = base;
+    }
+    allows(cap) {
+        return this.caps.has(cap);
+    }
+    isToolAllowed(toolName) {
+        const needed = TOOL_CAP[toolName];
+        if (!needed)
+            return true; // unknown tools — allow, but caller should validate
+        return this.allows(needed);
+    }
+}
+export function filterToolsByPermissions(tools, table) {
+    return tools.filter((t) => table.isToolAllowed(t.name));
+}
+export function isToolAllowed(toolName, table) {
+    return table.isToolAllowed(toolName);
+}

package/dist/plugin.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @vesk/agentic — Agentic AI plugin for Vesk.
+ *
+ * Zero-deps agent loop, provider abstraction, permissions, tools, checkpoints.
+ * Installable & toggleable: inactive ⇒ zero bundle/build cost. All AI
+ * machinery (provider/model/key, modes, permissions, context, tools,
+ * checkpoints) is owned by this plugin — core Vesk ships no agent runtime.
+ *
+ * @module agentic/plugin
+ */
+export interface AgenticOptions {
+    /** LLM provider. Default 'openai'. */
+    provider?: 'openai' | 'anthropic' | 'google' | 'ollama' | 'opencode' | 'opencode-go' | 'openrouter' | 'loopers' | 'custom';
+    /** Model name (e.g. gpt-4o-mini, claude-sonnet-4-6, gemini-2.0-flash, llama3.1). */
+    model?: string;
+    /** API key. Stored per-provider in the project `.env.local` as VK_{PROVIDER}_KEY — never commit to git. */
+    apiKey?: string;
+    /** Custom base URL for OpenAI-compatible providers or self-hosted Ollama. */
+    baseUrl?: string;
+    /** Max tokens for completion. */
+    maxTokens?: number;
+    /** Default agent mode (capability-gated via Dev Server). Default 'explore'. */
+    mode?: 'explore' | 'debug' | 'agent';
+    /** Max agent loop steps. Default 10. */
+    maxSteps?: number;
+}
+type AgenticPlugin = {
+    name: string;
+    dependencies: Set<string>;
+    onBuildStart: () => Promise<void>;
+    onBuildEnd: () => Promise<void>;
+    onFileWatch: (filePath: string) => Promise<{
+        handled: boolean;
+    }>;
+};
+export default function agenticPlugin(options?: AgenticOptions): AgenticPlugin;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3H,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2GAA2G;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAoBjF"}

package/dist/plugin.js

@@ -0,0 +1,28 @@
+/**
+ * @vesk/agentic — Agentic AI plugin for Vesk.
+ *
+ * Zero-deps agent loop, provider abstraction, permissions, tools, checkpoints.
+ * Installable & toggleable: inactive ⇒ zero bundle/build cost. All AI
+ * machinery (provider/model/key, modes, permissions, context, tools,
+ * checkpoints) is owned by this plugin — core Vesk ships no agent runtime.
+ *
+ * @module agentic/plugin
+ */
+export default function agenticPlugin(options = {}) {
+    void options;
+    return {
+        name: '@vesk/agentic',
+        dependencies: new Set(),
+        async onBuildStart() {
+            // No build-time transform: the agentic plugin is dev-server gated.
+            // Capabilities (agent, checkpoints) are served via the Dev Server API
+            // and rendered in the devtools AI panel when installed & active.
+        },
+        async onBuildEnd() {
+            // No-op: ensures validateConfig sees a recognized hook.
+        },
+        async onFileWatch(_filePath) {
+            return { handled: false };
+        },
+    };
+}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,13 @@
+import type { Provider } from '../loop.js';
+export interface AnthropicOptions {
+    apiKey: string;
+    model?: string;
+    maxTokens?: number;
+    baseUrl?: string;
+}
+export declare function listModels(options?: {
+    apiKey?: string;
+    baseUrl?: string;
+}): Promise<string[]>;
+export declare function anthropicProvider(options: AnthropicOptions): Provider;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkD,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,UAAU,CAAC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBvG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAqCrE"}