@troykelly/openclaw-projects 0.0.30 → 0.0.31

package/dist/tools/api-list.js

@@ -0,0 +1,46 @@
+/**
+ * api_list tool implementation.
+ * List all onboarded API sources.
+ * Part of API Onboarding feature (#1785).
+ */
+import { z } from 'zod';
+import { ApiSourceService } from '../services/api-source-service.js';
+import { sanitizeErrorMessage } from '../utils/sanitize.js';
+/** Parameters for api_list tool */
+export const ApiListParamsSchema = z.object({
+    limit: z.number().int().min(1).max(100).optional(),
+    offset: z.number().int().min(0).optional(),
+    status: z.enum(['active', 'error', 'disabled']).optional(),
+});
+export function createApiListTool(options) {
+    const { client, logger, user_id } = options;
+    const service = new ApiSourceService(client);
+    return {
+        name: 'api_list',
+        description: 'List all onboarded API sources. Optionally filter by status (active, error, disabled).',
+        parameters: ApiListParamsSchema,
+        async execute(params) {
+            const parseResult = ApiListParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                return { success: false, error: parseResult.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ') };
+            }
+            try {
+                const response = await service.list(parseResult.data, { user_id });
+                if (!response.success) {
+                    return { success: false, error: response.error.message || 'Failed to list API sources' };
+                }
+                const sources = response.data.data;
+                const lines = sources.length > 0
+                    ? sources.map((s) => `- ${s.name} (${s.status}) [${s.id}]`)
+                    : ['No API sources found.'];
+                const content = `${sources.length} API source(s):\n${lines.join('\n')}`;
+                return { success: true, data: { content, details: { count: sources.length, sources } } };
+            }
+            catch (error) {
+                logger.error('api_list failed', { user_id, error: error instanceof Error ? error.message : String(error) });
+                return { success: false, error: sanitizeErrorMessage(error) };
+            }
+        },
+    };
+}
+//# sourceMappingURL=api-list.js.map

package/dist/tools/api-list.js.map

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

package/dist/tools/api-onboard.d.ts

@@ -0,0 +1,134 @@
+/**
+ * api_onboard tool implementation.
+ * Onboards a new API by providing its OpenAPI spec URL or inline content.
+ * Part of API Onboarding feature (#1784).
+ */
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+import type { Logger } from '../logger.js';
+import type { PluginConfig } from '../config.js';
+/** Parameters for api_onboard tool */
+export declare const ApiOnboardParamsSchema: z.ZodEffects<z.ZodObject<{
+    spec_url: z.ZodOptional<z.ZodString>;
+    spec_content: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    credentials: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        header_name: z.ZodString;
+        header_prefix: z.ZodOptional<z.ZodString>;
+        resolve_strategy: z.ZodEnum<["literal", "env", "file", "command"]>;
+        resolve_reference: z.ZodString;
+        purpose: z.ZodOptional<z.ZodEnum<["api_call", "spec_fetch"]>>;
+    }, "strip", z.ZodTypeAny, {
+        header_name: string;
+        resolve_strategy: "file" | "command" | "literal" | "env";
+        resolve_reference: string;
+        purpose?: "api_call" | "spec_fetch" | undefined;
+        header_prefix?: string | undefined;
+    }, {
+        header_name: string;
+        resolve_strategy: "file" | "command" | "literal" | "env";
+        resolve_reference: string;
+        purpose?: "api_call" | "spec_fetch" | undefined;
+        header_prefix?: string | undefined;
+    }>, "many">>;
+    spec_auth_headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    credentials?: {
+        header_name: string;
+        resolve_strategy: "file" | "command" | "literal" | "env";
+        resolve_reference: string;
+        purpose?: "api_call" | "spec_fetch" | undefined;
+        header_prefix?: string | undefined;
+    }[] | undefined;
+    description?: string | undefined;
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    spec_url?: string | undefined;
+    spec_content?: string | undefined;
+    spec_auth_headers?: Record<string, string> | undefined;
+}, {
+    credentials?: {
+        header_name: string;
+        resolve_strategy: "file" | "command" | "literal" | "env";
+        resolve_reference: string;
+        purpose?: "api_call" | "spec_fetch" | undefined;
+        header_prefix?: string | undefined;
+    }[] | undefined;
+    description?: string | undefined;
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    spec_url?: string | undefined;
+    spec_content?: string | undefined;
+    spec_auth_headers?: Record<string, string> | undefined;
+}>, {
+    credentials?: {
+        header_name: string;
+        resolve_strategy: "file" | "command" | "literal" | "env";
+        resolve_reference: string;
+        purpose?: "api_call" | "spec_fetch" | undefined;
+        header_prefix?: string | undefined;
+    }[] | undefined;
+    description?: string | undefined;
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    spec_url?: string | undefined;
+    spec_content?: string | undefined;
+    spec_auth_headers?: Record<string, string> | undefined;
+}, {
+    credentials?: {
+        header_name: string;
+        resolve_strategy: "file" | "command" | "literal" | "env";
+        resolve_reference: string;
+        purpose?: "api_call" | "spec_fetch" | undefined;
+        header_prefix?: string | undefined;
+    }[] | undefined;
+    description?: string | undefined;
+    name?: string | undefined;
+    tags?: string[] | undefined;
+    spec_url?: string | undefined;
+    spec_content?: string | undefined;
+    spec_auth_headers?: Record<string, string> | undefined;
+}>;
+export type ApiOnboardParams = z.infer<typeof ApiOnboardParamsSchema>;
+/** Successful tool result */
+export interface ApiOnboardSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: {
+            api_source_id: string;
+            name: string;
+            memories_created: number;
+            memories_updated: number;
+            memories_deleted: number;
+        };
+    };
+}
+/** Failed tool result */
+export interface ApiOnboardFailure {
+    success: false;
+    error: string;
+}
+/** Tool result type */
+export type ApiOnboardResult = ApiOnboardSuccess | ApiOnboardFailure;
+/** Tool configuration */
+export interface ApiOnboardToolOptions {
+    client: ApiClient;
+    logger: Logger;
+    config: PluginConfig;
+    user_id: string;
+}
+/** Tool definition */
+export interface ApiOnboardTool {
+    name: string;
+    description: string;
+    parameters: typeof ApiOnboardParamsSchema;
+    execute: (params: ApiOnboardParams) => Promise<ApiOnboardResult>;
+}
+/**
+ * Creates the api_onboard tool.
+ */
+export declare function createApiOnboardTool(options: ApiOnboardToolOptions): ApiOnboardTool;
+//# sourceMappingURL=api-onboard.d.ts.map

package/dist/tools/api-onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-onboard.d.ts","sourceRoot":"","sources":["../../src/tools/api-onboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,sCAAsC;AACtC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YACP,aAAa,EAAE,MAAM,CAAC;YACtB,IAAI,EAAE,MAAM,CAAC;YACb,gBAAgB,EAAE,MAAM,CAAC;YACzB,gBAAgB,EAAE,MAAM,CAAC;YACzB,gBAAgB,EAAE,MAAM,CAAC;SAC1B,CAAC;KACH,CAAC;CACH;AAED,yBAAyB;AACzB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uBAAuB;AACvB,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAErE,yBAAyB;AACzB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sBAAsB;AACtB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,sBAAsB,CAAC;IAC1C,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA4FnF"}

package/dist/tools/api-onboard.js

@@ -0,0 +1,109 @@
+/**
+ * api_onboard tool implementation.
+ * Onboards a new API by providing its OpenAPI spec URL or inline content.
+ * Part of API Onboarding feature (#1784).
+ */
+import { z } from 'zod';
+import { ApiSourceService } from '../services/api-source-service.js';
+import { sanitizeErrorMessage } from '../utils/sanitize.js';
+/** Parameters for api_onboard tool */
+export const ApiOnboardParamsSchema = z.object({
+    spec_url: z.string().url('spec_url must be a valid URL').optional(),
+    spec_content: z.string().min(1, 'spec_content cannot be empty').optional(),
+    name: z.string().min(1).max(200).optional(),
+    description: z.string().max(2000).optional(),
+    tags: z.array(z.string().min(1).max(100)).max(20).optional(),
+    credentials: z.array(z.object({
+        header_name: z.string().min(1),
+        header_prefix: z.string().optional(),
+        resolve_strategy: z.enum(['literal', 'env', 'file', 'command']),
+        resolve_reference: z.string().min(1),
+        purpose: z.enum(['api_call', 'spec_fetch']).optional(),
+    })).optional(),
+    spec_auth_headers: z.record(z.string()).optional(),
+}).refine((data) => data.spec_url || data.spec_content, {
+    message: 'Either spec_url or spec_content is required',
+});
+/**
+ * Creates the api_onboard tool.
+ */
+export function createApiOnboardTool(options) {
+    const { client, logger, user_id } = options;
+    const service = new ApiSourceService(client);
+    return {
+        name: 'api_onboard',
+        description: 'Onboard a new API by providing its OpenAPI specification URL or inline spec content. ' +
+            'Parses the spec, decomposes it into searchable memories, and optionally stores credentials. ' +
+            'Use this when you need to teach the system about a new API.',
+        parameters: ApiOnboardParamsSchema,
+        async execute(params) {
+            const parseResult = ApiOnboardParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
+                return { success: false, error: errorMessage };
+            }
+            logger.info('api_onboard invoked', {
+                user_id,
+                spec_url: parseResult.data.spec_url,
+                has_spec_content: !!parseResult.data.spec_content,
+                credential_count: parseResult.data.credentials?.length ?? 0,
+            });
+            try {
+                const response = await service.onboard({
+                    spec_url: parseResult.data.spec_url,
+                    spec_content: parseResult.data.spec_content,
+                    name: parseResult.data.name,
+                    description: parseResult.data.description,
+                    tags: parseResult.data.tags,
+                    credentials: parseResult.data.credentials,
+                    spec_auth_headers: parseResult.data.spec_auth_headers,
+                }, { user_id });
+                if (!response.success) {
+                    logger.error('api_onboard API error', {
+                        user_id,
+                        status: response.error.status,
+                        code: response.error.code,
+                    });
+                    return {
+                        success: false,
+                        error: response.error.message || 'Failed to onboard API',
+                    };
+                }
+                const result = response.data.data;
+                const content = `Onboarded API "${result.api_source.name}" — ` +
+                    `${result.memories_created} memories created, ` +
+                    `${result.memories_updated} updated, ` +
+                    `${result.memories_deleted} deleted.`;
+                logger.debug('api_onboard completed', {
+                    user_id,
+                    api_source_id: result.api_source.id,
+                    memories_created: result.memories_created,
+                });
+                return {
+                    success: true,
+                    data: {
+                        content,
+                        details: {
+                            api_source_id: result.api_source.id,
+                            name: result.api_source.name,
+                            memories_created: result.memories_created,
+                            memories_updated: result.memories_updated,
+                            memories_deleted: result.memories_deleted,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('api_onboard failed', {
+                    user_id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return {
+                    success: false,
+                    error: sanitizeErrorMessage(error),
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=api-onboard.js.map

package/dist/tools/api-onboard.js.map

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

package/dist/tools/api-recall.d.ts

@@ -0,0 +1,69 @@
+/**
+ * api_recall tool implementation.
+ * Search onboarded API memories to find endpoints, operations, and capabilities.
+ * Part of API Onboarding feature (#1784).
+ */
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+import type { Logger } from '../logger.js';
+import type { PluginConfig } from '../config.js';
+import { type ApiMemorySearchResultResponse } from '../services/api-source-service.js';
+/** Parameters for api_recall tool */
+export declare const ApiRecallParamsSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    memory_kind: z.ZodOptional<z.ZodEnum<["overview", "tag_group", "operation"]>>;
+    api_source_id: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit?: number | undefined;
+    tags?: string[] | undefined;
+    api_source_id?: string | undefined;
+    memory_kind?: "operation" | "overview" | "tag_group" | undefined;
+}, {
+    query: string;
+    limit?: number | undefined;
+    tags?: string[] | undefined;
+    api_source_id?: string | undefined;
+    memory_kind?: "operation" | "overview" | "tag_group" | undefined;
+}>;
+export type ApiRecallParams = z.infer<typeof ApiRecallParamsSchema>;
+/** Successful tool result */
+export interface ApiRecallSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: {
+            count: number;
+            results: ApiMemorySearchResultResponse[];
+            user_id: string;
+        };
+    };
+}
+/** Failed tool result */
+export interface ApiRecallFailure {
+    success: false;
+    error: string;
+}
+/** Tool result type */
+export type ApiRecallResult = ApiRecallSuccess | ApiRecallFailure;
+/** Tool configuration */
+export interface ApiRecallToolOptions {
+    client: ApiClient;
+    logger: Logger;
+    config: PluginConfig;
+    user_id: string;
+}
+/** Tool definition */
+export interface ApiRecallTool {
+    name: string;
+    description: string;
+    parameters: typeof ApiRecallParamsSchema;
+    execute: (params: ApiRecallParams) => Promise<ApiRecallResult>;
+}
+/**
+ * Creates the api_recall tool.
+ */
+export declare function createApiRecallTool(options: ApiRecallToolOptions): ApiRecallTool;
+//# sourceMappingURL=api-recall.d.ts.map

package/dist/tools/api-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-recall.d.ts","sourceRoot":"","sources":["../../src/tools/api-recall.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAoB,KAAK,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAGzG,qCAAqC;AACrC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,6BAA6B;AAC7B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,6BAA6B,EAAE,CAAC;YACzC,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;CACH;AAED,yBAAyB;AACzB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uBAAuB;AACvB,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAElE,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,qBAAqB,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE;AAoBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA+EhF"}

package/dist/tools/api-recall.js

@@ -0,0 +1,101 @@
+/**
+ * api_recall tool implementation.
+ * Search onboarded API memories to find endpoints, operations, and capabilities.
+ * Part of API Onboarding feature (#1784).
+ */
+import { z } from 'zod';
+import { ApiSourceService } from '../services/api-source-service.js';
+import { sanitizeErrorMessage } from '../utils/sanitize.js';
+/** Parameters for api_recall tool */
+export const ApiRecallParamsSchema = z.object({
+    query: z.string().min(1, 'Query cannot be empty').max(1000, 'Query must be 1000 characters or less'),
+    limit: z.number().int().min(1).max(50).optional(),
+    memory_kind: z.enum(['overview', 'tag_group', 'operation']).optional(),
+    api_source_id: z.string().uuid('api_source_id must be a valid UUID').optional(),
+    tags: z.array(z.string().min(1).max(100)).max(20).optional(),
+});
+/**
+ * Format search results into a human-readable summary.
+ */
+function formatResults(results) {
+    if (results.length === 0) {
+        return 'No matching API operations found.';
+    }
+    const lines = [`Found ${results.length} matching API operation(s):`];
+    for (const r of results) {
+        const tags = r.tags.length > 0 ? ` [${r.tags.join(', ')}]` : '';
+        lines.push(`- ${r.title}${tags} (score: ${r.score.toFixed(2)})`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Creates the api_recall tool.
+ */
+export function createApiRecallTool(options) {
+    const { client, logger, user_id } = options;
+    const service = new ApiSourceService(client);
+    return {
+        name: 'api_recall',
+        description: 'Search through onboarded API memories to find endpoints, operations, and capabilities. ' +
+            'Returns operation details including method, path, parameters, and credentials. ' +
+            'Use this when you need to find how to call an API.',
+        parameters: ApiRecallParamsSchema,
+        async execute(params) {
+            const parseResult = ApiRecallParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                const errorMessage = parseResult.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
+                return { success: false, error: errorMessage };
+            }
+            const { query, limit = 10, memory_kind, api_source_id, tags } = parseResult.data;
+            logger.info('api_recall invoked', {
+                user_id,
+                query,
+                limit,
+                memory_kind,
+                api_source_id,
+            });
+            try {
+                const response = await service.search({ q: query, limit, memory_kind, api_source_id, tags }, { user_id });
+                if (!response.success) {
+                    logger.error('api_recall API error', {
+                        user_id,
+                        status: response.error.status,
+                        code: response.error.code,
+                    });
+                    return {
+                        success: false,
+                        error: response.error.message || 'Failed to search API memories',
+                    };
+                }
+                const results = response.data.data;
+                const content = formatResults(results);
+                logger.debug('api_recall completed', {
+                    user_id,
+                    resultCount: results.length,
+                });
+                return {
+                    success: true,
+                    data: {
+                        content,
+                        details: {
+                            count: results.length,
+                            results,
+                            user_id,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('api_recall failed', {
+                    user_id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                return {
+                    success: false,
+                    error: sanitizeErrorMessage(error),
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=api-recall.js.map

package/dist/tools/api-recall.js.map

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

package/dist/tools/api-refresh.d.ts

@@ -0,0 +1,50 @@
+/**
+ * api_refresh tool implementation.
+ * Refresh an API source by re-fetching and re-parsing its OpenAPI spec.
+ * Part of API Onboarding feature (#1785).
+ */
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+import type { Logger } from '../logger.js';
+import type { PluginConfig } from '../config.js';
+/** Parameters for api_refresh tool */
+export declare const ApiRefreshParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type ApiRefreshParams = z.infer<typeof ApiRefreshParamsSchema>;
+export interface ApiRefreshSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: {
+            api_source_id: string;
+            spec_changed: boolean;
+            memories_created: number;
+            memories_updated: number;
+            memories_deleted: number;
+        };
+    };
+}
+export interface ApiRefreshFailure {
+    success: false;
+    error: string;
+}
+export type ApiRefreshResult = ApiRefreshSuccess | ApiRefreshFailure;
+export interface ApiRefreshToolOptions {
+    client: ApiClient;
+    logger: Logger;
+    config: PluginConfig;
+    user_id: string;
+}
+export interface ApiRefreshTool {
+    name: string;
+    description: string;
+    parameters: typeof ApiRefreshParamsSchema;
+    execute: (params: ApiRefreshParams) => Promise<ApiRefreshResult>;
+}
+export declare function createApiRefreshTool(options: ApiRefreshToolOptions): ApiRefreshTool;
+//# sourceMappingURL=api-refresh.d.ts.map

package/dist/tools/api-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-refresh.d.ts","sourceRoot":"","sources":["../../src/tools/api-refresh.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,sCAAsC;AACtC,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YACP,aAAa,EAAE,MAAM,CAAC;YACtB,YAAY,EAAE,OAAO,CAAC;YACtB,gBAAgB,EAAE,MAAM,CAAC;YACzB,gBAAgB,EAAE,MAAM,CAAC;YACzB,gBAAgB,EAAE,MAAM,CAAC;SAC1B,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAErE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,sBAAsB,CAAC;IAC1C,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAClE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA8CnF"}

package/dist/tools/api-refresh.js

@@ -0,0 +1,55 @@
+/**
+ * api_refresh tool implementation.
+ * Refresh an API source by re-fetching and re-parsing its OpenAPI spec.
+ * Part of API Onboarding feature (#1785).
+ */
+import { z } from 'zod';
+import { ApiSourceService } from '../services/api-source-service.js';
+import { sanitizeErrorMessage } from '../utils/sanitize.js';
+/** Parameters for api_refresh tool */
+export const ApiRefreshParamsSchema = z.object({
+    id: z.string().uuid('id must be a valid UUID'),
+});
+export function createApiRefreshTool(options) {
+    const { client, logger, user_id } = options;
+    const service = new ApiSourceService(client);
+    return {
+        name: 'api_refresh',
+        description: 'Refresh an API source by re-fetching its OpenAPI spec and updating memories. Returns a diff summary.',
+        parameters: ApiRefreshParamsSchema,
+        async execute(params) {
+            const parseResult = ApiRefreshParamsSchema.safeParse(params);
+            if (!parseResult.success) {
+                return { success: false, error: parseResult.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ') };
+            }
+            try {
+                const response = await service.refresh(parseResult.data.id, { user_id });
+                if (!response.success) {
+                    return { success: false, error: response.error.message || 'Failed to refresh API source' };
+                }
+                const result = response.data.data;
+                const content = result.spec_changed
+                    ? `Refreshed "${result.api_source.name}" — spec changed: ${result.memories_created} added, ${result.memories_updated} updated, ${result.memories_deleted} removed.`
+                    : `Refreshed "${result.api_source.name}" — spec unchanged, no updates needed.`;
+                return {
+                    success: true,
+                    data: {
+                        content,
+                        details: {
+                            api_source_id: result.api_source.id,
+                            spec_changed: result.spec_changed,
+                            memories_created: result.memories_created,
+                            memories_updated: result.memories_updated,
+                            memories_deleted: result.memories_deleted,
+                        },
+                    },
+                };
+            }
+            catch (error) {
+                logger.error('api_refresh failed', { user_id, error: error instanceof Error ? error.message : String(error) });
+                return { success: false, error: sanitizeErrorMessage(error) };
+            }
+        },
+    };
+}
+//# sourceMappingURL=api-refresh.js.map

package/dist/tools/api-refresh.js.map

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

package/dist/tools/api-remove.d.ts

@@ -0,0 +1,46 @@
+/**
+ * api_remove tool implementation.
+ * Soft-delete an onboarded API source.
+ * Part of API Onboarding feature (#1785).
+ */
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+import type { Logger } from '../logger.js';
+import type { PluginConfig } from '../config.js';
+/** Parameters for api_remove tool */
+export declare const ApiRemoveParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type ApiRemoveParams = z.infer<typeof ApiRemoveParamsSchema>;
+export interface ApiRemoveSuccess {
+    success: true;
+    data: {
+        content: string;
+        details: {
+            id: string;
+        };
+    };
+}
+export interface ApiRemoveFailure {
+    success: false;
+    error: string;
+}
+export type ApiRemoveResult = ApiRemoveSuccess | ApiRemoveFailure;
+export interface ApiRemoveToolOptions {
+    client: ApiClient;
+    logger: Logger;
+    config: PluginConfig;
+    user_id: string;
+}
+export interface ApiRemoveTool {
+    name: string;
+    description: string;
+    parameters: typeof ApiRemoveParamsSchema;
+    execute: (params: ApiRemoveParams) => Promise<ApiRemoveResult>;
+}
+export declare function createApiRemoveTool(options: ApiRemoveToolOptions): ApiRemoveTool;
+//# sourceMappingURL=api-remove.d.ts.map