@qodo/sdk 0.8.0 → 0.10.0

package/.claude/skills/qodo-agent/SKILL.md

@@ -46,6 +46,10 @@ Use this skill when working with `@qodo/sdk` to build AI-powered agents. This sk
 | `sdkPipeline()` | Build multi-step agent workflows |
 | `runPipeline()` | Execute a pipeline with an SDK instance |
 | `PipelineExecutionError` | Pipeline step failure error |
+| `.step()` | Add a sequential step with typed state threading |
+| `.parallel()` | Add a group of steps that execute concurrently |
+| `.gate()` | Pipeline-level barrier — halts subsequent entries when false |
+| `.branch()` | Pipeline-level if/else fork with sub-pipeline paths |
 
 ### Tool Middleware
 
@@ -91,8 +95,9 @@ Use this skill when working with `@qodo/sdk` to build AI-powered agents. This sk
 
 | Export | Purpose |
 |--------|---------|
-| `QodoInfoClient` | Backend info (models, capabilities) |
+| `QodoInfoClient` | Backend info (models, capabilities, rate limits) |
 | `QodoSessionsClient` | Session history management |
+| `QodoToolsClient` | Tool discovery (built-in + backend tools) |
 
 ### Errors
 
@@ -493,8 +498,9 @@ const pipeline = sdkPipeline<{ repo: string }>()
     const r = await run('lint', { args: { path: state.repo } });
     return { lintOutput: r.result.final_output };
   })
+  // Gate: only continue review if lint produced output
+  .gate((state) => !!state.lintOutput)
   .step('review', async ({ state, run }) => {
-    // TypeScript knows state has `repo` + `lintOutput`
     const r = await run('review', {
       extraInstructions: `Lint results:\n${state.lintOutput}`,
     });
@@ -509,7 +515,37 @@ console.log(result.steps); // Step logs with timing
 await sdk.dispose();
 ```
 
-Features: typed state threading, `.parallel([...])`, gates, error strategies (`'skip'`, `'throw'`, custom recovery).
+Features: typed state threading, `.parallel([...])`, `.gate()` (pipeline barriers), `.branch()` (if/else forks), error strategies (`'skip'`, `'throw'`, custom recovery).
+
+### Pattern 8b: Pipeline Branches
+
+```typescript
+import { QodoSDK, sdkPipeline, runPipeline } from '@qodo/sdk';
+
+const sdk = new QodoSDK({ autoApproveTools: true });
+
+const pipeline = sdkPipeline<{ fileCount: number }>()
+  .branch(
+    (state) => state.fileCount > 20,
+    {
+      true: (b) => b.step('deep', async ({ run }) => {
+        const r = await run('analyze-deep');
+        return { analysis: r.result.final_output };
+      }),
+      false: (b) => b.step('quick', async ({ run }) => {
+        const r = await run('summarize');
+        return { analysis: r.result.final_output };
+      }),
+    },
+    { name: 'size-check' },
+  )
+  .step('report', async ({ state }) => ({
+    report: `${state.fileCount} files: ${state.analysis}`,
+  }))
+  .build();
+
+await sdk.dispose();
+```
 
 ### Pattern 9: Dry Run Mode
 
@@ -653,6 +689,57 @@ await sdk.dispose();
 
 No compile-time OTel dependency — install `@opentelemetry/api` as optional peer dep.
 
+### Pattern 15: Backend Info Client (Standalone)
+
+```typescript
+import { QodoInfoClient } from '@qodo/sdk';
+
+// Standalone — no run/stream needed
+const info = new QodoInfoClient();
+const things = await info.getThings();
+console.log(things.available_models);  // ['gpt-4', 'gpt-4o', ...]
+console.log(things.default_model);     // 'gpt-4o'
+console.log(things.session_id);        // new backend session ID
+console.log(things.rate_limit);        // { remaining, reset, limit }
+
+// Convenience
+const models = await info.getAvailableModels();
+
+// Via SDK instance
+const sdk = new QodoSDK();
+const defaultModel = await sdk.info.getDefaultModel();
+```
+
+### Pattern 16: Tool Discovery Client (Standalone)
+
+```typescript
+import { QodoToolsClient } from '@qodo/sdk';
+
+// Standalone — no run/stream needed
+const client = new QodoToolsClient();
+
+// List all tools (built-in + backend)
+const tools = await client.getTools();
+for (const tool of tools) {
+  console.log(`${tool.server}.${tool.name} (${tool.serverType})`);
+  // e.g. "filesystem.read_files (builtin)"
+  // e.g. "sequential_thinking.sequential_thinking (backend)"
+}
+
+// Group by server
+const byServer = await client.getToolsByServer();
+console.log(Object.keys(byServer));
+// ['filesystem', 'git', 'ripgrep', 'shell', 'sequential_thinking', ...]
+
+// Filter by type
+const backendOnly = tools.filter(t => t.serverType === 'backend');
+const builtinOnly = tools.filter(t => t.serverType === 'builtin');
+
+// Via SDK instance
+const sdk = new QodoSDK();
+const allTools = await sdk.tools.getTools();
+```
+
 ---
 
 ## Zod Schema Patterns
@@ -876,6 +963,7 @@ z.object({
 
 | Feature | Doc |
 |---------|-----|
+| API Reference (Clients, Options, Types) | [docs/api-reference.md](../../../docs/api-reference.md) |
 | Pipeline DSL | [docs/pipeline.md](../../../docs/pipeline.md) |
 | Dry Run Mode | [docs/dry-run.md](../../../docs/dry-run.md) |
 | Tool Middleware | [docs/tool-middleware.md](../../../docs/tool-middleware.md) |

package/.claude/skills/qodo-agent/assets/programmatic-agent.ts

@@ -319,7 +319,7 @@ async function main() {
     // @ts-ignore
     console.log('Response:', promptResult.final_output);
     // -------------------------------------------------------------------------
-    // Example 4: Pipeline (multi-step workflow)
+    // Example 4: Pipeline (multi-step workflow with gates and branches)
     // -------------------------------------------------------------------------
     console.log('\n\n--- Pipeline example ---\n');
 
@@ -328,18 +328,34 @@ async function main() {
         const r = await run('analyze', { args: { path: state.path } });
         return { analysis: r.result.structured_output };
       })
-      .step('summarize', async ({ state, run }) => {
-        const r = await run('', {
-          extraInstructions: `Summarize these findings in one paragraph: ${JSON.stringify(state.analysis)}`,
-        });
-        return { summary: r.result.final_output };
-      })
+      // Gate: only continue if analysis produced results
+      .gate((state) => !!state.analysis, { name: 'has-analysis' })
+      // Branch: choose different summary strategies based on score
+      .branch(
+        (state) => (state.analysis as any)?.score > 80,
+        {
+          true: (b) => b.step('brief-summary', async ({ state, run }) => {
+            const r = await run('', {
+              extraInstructions: `High quality code (score: ${(state.analysis as any)?.score}). Brief summary: ${JSON.stringify(state.analysis)}`,
+            });
+            return { summary: r.result.final_output };
+          }),
+          false: (b) => b.step('detailed-summary', async ({ state, run }) => {
+            const r = await run('', {
+              extraInstructions: `Code needs improvement. Detailed summary with recommendations: ${JSON.stringify(state.analysis)}`,
+            });
+            return { summary: r.result.final_output };
+          }),
+        },
+        { name: 'quality-check' },
+      )
       .build();
 
     const pipelineResult = await runPipeline(sdk, pipeline, { path: './src' });
     console.log('Pipeline summary:', pipelineResult.state.summary);
     for (const log of pipelineResult.steps) {
-      console.log(`  ${log.name}: ${log.status} (${log.durationMs}ms)`);
+      const branch = log.branchTaken ? ` (branch: ${log.branchTaken})` : '';
+      console.log(`  ${log.name}: ${log.status}${branch} (${log.durationMs}ms)`);
     }
 
     // -------------------------------------------------------------------------

package/.claude/skills/qodo-agent/references/common-issues.md

@@ -433,11 +433,12 @@ PipelineExecutionError: Step "lint" failed: ...
 
 **Cause:** A pipeline step threw an error and no error strategy was set.
 
-**Solution:** Add error handling per step:
+**Solution:** Add error handling per step, or use gates to guard steps:
 
 ```typescript
 sdkPipeline()
   .step('lint', lintFn, { onError: 'skip' })        // Skip on failure
+  .gate((state) => !!state.lintOutput)               // Gate: halt if no lint output
   .step('review', reviewFn, {
     onError: (error, state) => ({ fallback: true }),  // Custom recovery
   })

package/README.md

@@ -135,6 +135,20 @@ choco install ripgrep
 
 If ripgrep is not available, the `ripgrep_search` tool will be unavailable and the SDK will log a warning. All other functionality works normally.
 
+## Claude Code Skill
+
+The SDK ships with a Claude Code skill that provides context-aware assistance when building Qodo agents. Install it with:
+
+```bash
+# Install to your project
+npx @qodo/sdk install-skill
+
+# Or install globally (available in all projects)
+npx @qodo/sdk install-skill --global
+```
+
+Once installed, use `/qodo-agent` in Claude Code to get help with agent configuration, SDK APIs, and common patterns.
+
 ## Documentation
 
 | Guide | Description |

package/dist/clients/index.d.ts

@@ -5,4 +5,6 @@
 export type { QodoInfoClientOptions, QodoBackendInfo, BaseUrlSource, RateLimitInfo } from './info/index.js';
 export { QodoSessionsClient } from './sessions/index.js';
 export type { QodoSessionsClientOptions, RecentSession, SessionHistory, SessionMessage } from './sessions/index.js';
+export { QodoToolsClient } from './tools/index.js';
+export type { QodoToolsClientOptions, QodoToolInfo } from './tools/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/clients/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,yBAAyB,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,yBAAyB,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/clients/index.js

@@ -4,4 +4,5 @@
  */
 export { QodoInfoClient } from './info/index.js';
 export { QodoSessionsClient } from './sessions/index.js';
+export { QodoToolsClient } from './tools/index.js';
 //# sourceMappingURL=index.js.map

package/dist/clients/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clients/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/clients/tools/ToolsClient.d.ts

@@ -0,0 +1,39 @@
+import type { QodoSDKOptions } from '../../sdk/QodoSDK.js';
+import type { QodoToolInfo } from './types.js';
+export type QodoToolsClientOptions = {
+    /** baseUrl override passed to the SDK (options.backend.baseUrl) */
+    baseUrlOverride?: string;
+};
+/**
+ * QodoToolsClient
+ *
+ * Public-facing SDK facade for discovering available tools
+ * (built-in MCP servers + backend-provided tools).
+ *
+ * Follows the same pattern as QodoInfoClient — bootstraps the backend
+ * connection on first call, then returns normalized tool info.
+ */
+export declare class QodoToolsClient {
+    private readonly opts;
+    private cache?;
+    constructor(opts?: QodoToolsClientOptions);
+    private ensureInitialized;
+    private buildCatalog;
+    /**
+     * Returns all available tools (built-in + backend).
+     */
+    getTools(opts?: {
+        forceRefresh?: boolean;
+    }): Promise<QodoToolInfo[]>;
+    /**
+     * Returns tools grouped by server id.
+     */
+    getToolsByServer(opts?: {
+        forceRefresh?: boolean;
+    }): Promise<Record<string, QodoToolInfo[]>>;
+    /**
+     * Helper for SDK integration: build tools client options from SDK options.
+     */
+    static fromSdkOptions(sdkOpts: QodoSDKOptions): QodoToolsClient;
+}
+//# sourceMappingURL=ToolsClient.d.ts.map

package/dist/clients/tools/ToolsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolsClient.d.ts","sourceRoot":"","sources":["../../../src/clients/tools/ToolsClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAAG;IACnC,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,KAAK,CAAC,CAAiB;gBAEF,IAAI,GAAE,sBAA2B;YAEhD,iBAAiB;YASjB,YAAY;IA0C1B;;OAEG;IACG,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAK1E;;OAEG;IACG,gBAAgB,CAAC,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAUlG;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe;CAGhE"}

package/dist/clients/tools/ToolsClient.js

@@ -0,0 +1,95 @@
+import { BackendBootstrap } from '../../sdk/bootstrap.js';
+import { ServerData } from '../../session/index.js';
+import { BuiltInServers } from '../../mcp/builtinServers.js';
+/**
+ * QodoToolsClient
+ *
+ * Public-facing SDK facade for discovering available tools
+ * (built-in MCP servers + backend-provided tools).
+ *
+ * Follows the same pattern as QodoInfoClient — bootstraps the backend
+ * connection on first call, then returns normalized tool info.
+ */
+export class QodoToolsClient {
+    opts;
+    cache;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async ensureInitialized(forceRefresh = false) {
+        if (forceRefresh || !this.cache) {
+            const bootstrap = new BackendBootstrap({ baseUrlOverride: this.opts.baseUrlOverride });
+            await bootstrap.init();
+            await ServerData.init(this.opts.baseUrlOverride);
+            this.cache = await this.buildCatalog();
+        }
+    }
+    async buildCatalog() {
+        const catalog = [];
+        // Built-in servers
+        const builtIn = new BuiltInServers();
+        const servers = await builtIn.getServers();
+        for (const server of servers) {
+            const instance = builtIn.getBuiltInServer(server.id);
+            if (!instance)
+                continue;
+            try {
+                await instance.initialize();
+                const { tools } = await instance.listTools();
+                for (const tool of tools) {
+                    catalog.push({
+                        server: server.id,
+                        serverType: 'builtin',
+                        name: tool.name,
+                        description: tool.description,
+                    });
+                }
+            }
+            catch { /* best-effort: skip servers that fail to initialize */ }
+        }
+        // Backend tools from get-things
+        try {
+            const serverData = ServerData.getInstance();
+            const backendTools = serverData.getMCPTools();
+            for (const [serverId, tools] of Object.entries(backendTools)) {
+                for (const tool of tools) {
+                    catalog.push({
+                        server: serverId,
+                        serverType: 'backend',
+                        name: tool.name,
+                        description: tool.description,
+                    });
+                }
+            }
+        }
+        catch { /* best-effort: backend tools may not be available */ }
+        return catalog;
+    }
+    /**
+     * Returns all available tools (built-in + backend).
+     */
+    async getTools(opts) {
+        await this.ensureInitialized(!!opts?.forceRefresh);
+        return [...this.cache];
+    }
+    /**
+     * Returns tools grouped by server id.
+     */
+    async getToolsByServer(opts) {
+        const tools = await this.getTools(opts);
+        const grouped = {};
+        for (const tool of tools) {
+            if (!grouped[tool.server])
+                grouped[tool.server] = [];
+            grouped[tool.server].push(tool);
+        }
+        return grouped;
+    }
+    /**
+     * Helper for SDK integration: build tools client options from SDK options.
+     */
+    static fromSdkOptions(sdkOpts) {
+        return new QodoToolsClient({ baseUrlOverride: sdkOpts?.backend?.baseUrl });
+    }
+}
+//# sourceMappingURL=ToolsClient.js.map

package/dist/clients/tools/ToolsClient.js.map

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

package/dist/clients/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { QodoToolsClient } from './ToolsClient.js';
+export type { QodoToolsClientOptions } from './ToolsClient.js';
+export type { QodoToolInfo } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/clients/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/clients/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/clients/tools/index.js

@@ -0,0 +1,2 @@
+export { QodoToolsClient } from './ToolsClient.js';
+//# sourceMappingURL=index.js.map

package/dist/clients/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clients/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/clients/tools/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Describes a single tool available on an MCP server.
+ */
+export type QodoToolInfo = {
+    /** Server that owns this tool (e.g. "filesystem", "git", "shell"). */
+    server: string;
+    /** Server type: builtin or backend. */
+    serverType: 'builtin' | 'backend';
+    /** Tool name as used in tool calls. */
+    name: string;
+    /** Human-readable description of the tool. */
+    description?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/clients/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/clients/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/clients/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/clients/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/clients/tools/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { QodoSDK } from './sdk/index.js';
 export type { QodoSDKOptions, QodoSDKRunResult, QodoSDKStreamEvent, QodoSDKRunOptions, QodoSDKLogger, } from './sdk/index.js';
 export { SdkEventType, SDK_PROTOCOL_V2, matchSdkEvent, createSdkEvent, getSdkVersion, } from './sdk/events.js';
-export type { QodoSdkEvent, SdkEventTypeName, SdkEventEnvelope, SdkInitEvent, SdkRunStartedEvent, SdkMessageDeltaEvent, SdkMessageFullEvent, SdkProgressEvent, SdkToolRequestedEvent, SdkToolApprovedEvent, SdkToolExecutedEvent, SdkErrorEvent, SdkFinalEvent, SdkEventHandlers, SdkPipelineStartedEvent, SdkPipelineStepStartedEvent, SdkPipelineStepCompletedEvent, SdkPipelineGateEvaluatedEvent, SdkPipelineCompletedEvent, SdkPipelineErrorEvent, } from './sdk/events.js';
+export type { QodoSdkEvent, SdkEventTypeName, SdkEventEnvelope, SdkInitEvent, SdkRunStartedEvent, SdkMessageDeltaEvent, SdkMessageFullEvent, SdkProgressEvent, SdkToolRequestedEvent, SdkToolApprovedEvent, SdkToolExecutedEvent, SdkErrorEvent, SdkFinalEvent, SdkEventHandlers, SdkPipelineStartedEvent, SdkPipelineStepStartedEvent, SdkPipelineStepCompletedEvent, SdkPipelineGateEvaluatedEvent, SdkPipelineBranchEvaluatedEvent, SdkPipelineCompletedEvent, SdkPipelineErrorEvent, } from './sdk/events.js';
 export { sdkAgent, sdkCommand, sdkArgs } from './sdk/builders.js';
 export { zodOutputSchema, zodArgsSchema, zCoerce, zJsonValue, zJsonAny, parseArgsWithSchema, QodoSchemaError, } from './sdk/schemas.js';
 export { z } from 'zod/v3';
@@ -9,6 +9,8 @@ export { QodoInfoClient } from './clients/info/index.js';
 export type { QodoBackendInfo } from './clients/info/types.js';
 export { QodoSessionsClient } from './clients/sessions/index.js';
 export type { RecentSession, SessionHistory, SessionMessage, } from './clients/sessions/types.js';
+export { QodoToolsClient } from './clients/tools/index.js';
+export type { QodoToolInfo } from './clients/tools/types.js';
 export { findNearestAgentConfig } from './sdk/discovery.js';
 export { buildDefaultSdkAgentConfig } from './sdk/defaults.js';
 export { QodoTracker } from './tracking/index.js';
@@ -19,7 +21,7 @@ export type { ToolCall, AIMessageInput, ToolMessageInput } from './messages/inde
 export { convertMessagesToOpenAI } from './messages/index.js';
 export type { OpenAIChatMessage } from './messages/index.js';
 export { sdkPipeline, PipelineBuilder, Pipeline, runPipeline, PipelineExecutionError } from './sdk/pipeline/index.js';
-export type { StepFn, StepContext, GateFn, ErrorStrategy, PipelineResult, StepLog, StepOptions, PipelineEventCallback, } from './sdk/pipeline/index.js';
+export type { StepFn, StepContext, GateFn, ErrorStrategy, PipelineGate, PipelineBranch, PipelineResult, StepLog, StepOptions, PipelineEventCallback, } from './sdk/pipeline/index.js';
 export { compileDeclarativePipeline, DeclarativePipelineValidationError } from './sdk/pipeline/index.js';
 export type { DeclarativePipelineStep, DeclarativePipeline } from './sdk/pipeline/index.js';
 export type { ToolMiddleware } from './sdk/middleware.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -8,9 +8,10 @@ export { zodOutputSchema, zodArgsSchema, zCoerce, zJsonValue, zJsonAny, parseArg
 // Re-export zod for convenience and type compatibility
 // Users can import { z } from '@qodo/sdk' to ensure compatibility with SDK schema functions
 export { z } from 'zod/v3';
-// Info & Sessions clients
+// Info, Sessions & Tools clients
 export { QodoInfoClient } from './clients/info/index.js';
 export { QodoSessionsClient } from './clients/sessions/index.js';
+export { QodoToolsClient } from './clients/tools/index.js';
 // Agent discovery & defaults
 export { findNearestAgentConfig } from './sdk/discovery.js';
 export { buildDefaultSdkAgentConfig } from './sdk/defaults.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AASzC,SAAS;AACT,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAyBzB,uBAAuB;AACvB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,UAAU,EACV,QAAQ,EACR,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,uDAAuD;AACvD,4FAA4F;AAC5F,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOjE,6BAA6B;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYlD,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qEAAqE;AACrE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAYtH,uBAAuB;AACvB,OAAO,EAAE,0BAA0B,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAKzG,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAExG,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGjG,4CAA4C;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGlF,+BAA+B;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,gCAAgC;AAChC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AASzC,SAAS;AACT,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AA0BzB,uBAAuB;AACvB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,UAAU,EACV,QAAQ,EACR,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,uDAAuD;AACvD,4FAA4F;AAC5F,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,iCAAiC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG3D,6BAA6B;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYlD,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,qEAAqE;AACrE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AActH,uBAAuB;AACvB,OAAO,EAAE,0BAA0B,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAKzG,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAExG,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGjG,4CAA4C;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGlF,+BAA+B;AAC/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,gCAAgC;AAChC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/sdk/QodoSDK.d.ts

@@ -1,4 +1,4 @@
-import { QodoInfoClient, QodoSessionsClient } from '../clients/index.js';
+import { QodoInfoClient, QodoSessionsClient, QodoToolsClient } from '../clients/index.js';
 import { AIAssistantConfig, MCPConfig } from '../parser/types.js';
 import { type QodoSdkEvent, SdkEventType } from './events.js';
 export type QodoSDKLogger = {
@@ -125,6 +125,8 @@ export declare class QodoSDK {
     readonly info: QodoInfoClient;
     /** Session history facade */
     readonly sessions: QodoSessionsClient;
+    /** Tool discovery facade */
+    readonly tools: QodoToolsClient;
     private initialized;
     private readonly env;
     private readonly logger;

package/dist/sdk/QodoSDK.d.ts.map

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

package/dist/sdk/QodoSDK.js

@@ -9,7 +9,7 @@ import { AgentAPI } from '../api/agent.js';
 import { AgentRunnerCore } from './runner/index.js';
 import { BackendBootstrap } from './bootstrap.js';
 import { AuthProvider } from '../auth/index.js';
-import { QodoInfoClient, QodoSessionsClient } from '../clients/index.js';
+import { QodoInfoClient, QodoSessionsClient, QodoToolsClient } from '../clients/index.js';
 import { canonicalizePathSync, extractSetFlags } from '../utils/index.js';
 import { extractProgress } from './runner/progress.js';
 import { toLangChainDict, toOpenAIChat } from './runner/formats.js';
@@ -21,6 +21,8 @@ export class QodoSDK {
     info;
     /** Session history facade */
     sessions;
+    /** Tool discovery facade */
+    tools;
     initialized = false;
     // Environment for AsyncLocalStorage-scoped singletons.
     // Mark as sdkMode to avoid process.exit in SDK code paths.
@@ -60,6 +62,7 @@ export class QodoSDK {
         this.options = options;
         this.info = QodoInfoClient.fromSdkOptions(options);
         this.sessions = QodoSessionsClient.fromSdkOptions(options);
+        this.tools = QodoToolsClient.fromSdkOptions(options);
         // If debug is enabled, allow verbose logs in this SDK environment.
         if (this.options.debug === true) {
             this.env.sdkDebug = true;