@inkeep/agents-manage-api 0.0.0-dev-20250910233133 → 0.0.0-dev-20250910233151

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-manage-api",
-  "version": "0.0.0-dev-20250910233133",
+  "version": "0.0.0-dev-20250910233151",
   "description": "Management API for Inkeep Agent Framework - handles CRUD operations and OAuth",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,7 @@
     "pino": "^9.7.0",
     "pino-pretty": "^13.0.0",
     "zod": "^4.1.5",
-    "@inkeep/agents-core": "^0.0.0-dev-20250910233133"
+    "@inkeep/agents-core": "^0.0.0-dev-20250910233151"
   },
   "devDependencies": {
     "@biomejs/biome": "2.1.4",
@@ -59,7 +59,7 @@
   },
   "scripts": {
     "dev": "vite",
-    "build": "tsc",
+    "build": "tsup",
     "start": "node dist/server.js",
     "test": "vitest --run",
     "test:watch": "vitest",

package/dist/__tests__/setup.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=setup.d.ts.map

package/dist/__tests__/setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":""}

package/dist/__tests__/setup.js

@@ -1,26 +0,0 @@
-import { getLogger } from '@inkeep/agents-core';
-import { sql } from 'drizzle-orm';
-import { migrate } from 'drizzle-orm/libsql/migrator';
-import { afterAll, afterEach, beforeAll } from 'vitest';
-import dbClient from '../data/db/dbClient';
-// Initialize database schema for in-memory test databases using Drizzle migrations
-beforeAll(async () => {
-    const logger = getLogger('Test Setup');
-    try {
-        logger.debug({}, 'Applying database migrations to in-memory test database');
-        // Temporarily disable foreign key constraints for tests due to composite key issues
-        await dbClient.run(sql `PRAGMA foreign_keys = OFF`);
-        await migrate(dbClient, { migrationsFolder: '../packages/agents-core/drizzle' });
-        logger.debug({}, 'Database migrations applied successfully');
-    }
-    catch (error) {
-        logger.error({ error }, 'Failed to apply database migrations');
-        throw error;
-    }
-});
-afterEach(() => {
-    // Any cleanup if needed
-});
-afterAll(() => {
-    // Any final cleanup if needed
-});

package/dist/__tests__/utils/testProject.d.ts

@@ -1,18 +0,0 @@
-/**
- * Ensures a project exists for a given tenant ID.
- * This is needed because of foreign key constraints in the database.
- *
- * @param tenantId - The tenant ID
- * @param projectId - The project ID (defaults to 'default')
- * @returns Promise that resolves when the project is created
- */
-export declare function ensureTestProject(tenantId: string, projectId?: string): Promise<void>;
-/**
- * Creates multiple test projects for a tenant.
- *
- * @param tenantId - The tenant ID
- * @param projectIds - Array of project IDs to create
- * @returns Promise that resolves when all projects are created
- */
-export declare function ensureTestProjects(tenantId: string, projectIds: string[]): Promise<void>;
-//# sourceMappingURL=testProject.d.ts.map

package/dist/__tests__/utils/testProject.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"testProject.d.ts","sourceRoot":"","sources":["../../../src/__tests__/utils/testProject.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9F;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9F"}

package/dist/__tests__/utils/testProject.js

@@ -1,26 +0,0 @@
-import { sql } from 'drizzle-orm';
-import dbClient from '../../data/db/dbClient';
-/**
- * Ensures a project exists for a given tenant ID.
- * This is needed because of foreign key constraints in the database.
- *
- * @param tenantId - The tenant ID
- * @param projectId - The project ID (defaults to 'default')
- * @returns Promise that resolves when the project is created
- */
-export async function ensureTestProject(tenantId, projectId = 'default') {
-    await dbClient.run(sql `
-    INSERT OR IGNORE INTO projects (tenant_id, id, name, description, created_at, updated_at)
-    VALUES (${tenantId}, ${projectId}, ${`Test Project ${projectId}`}, ${`Test project for ${projectId}`}, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
-  `);
-}
-/**
- * Creates multiple test projects for a tenant.
- *
- * @param tenantId - The tenant ID
- * @param projectIds - Array of project IDs to create
- * @returns Promise that resolves when all projects are created
- */
-export async function ensureTestProjects(tenantId, projectIds) {
-    await Promise.all(projectIds.map((projectId) => ensureTestProject(tenantId, projectId)));
-}

package/dist/__tests__/utils/testRequest.d.ts

@@ -1,2 +0,0 @@
-export declare const makeRequest: (url: string, options?: RequestInit) => Promise<Response>;
-//# sourceMappingURL=testRequest.d.ts.map

package/dist/__tests__/utils/testRequest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"testRequest.d.ts","sourceRoot":"","sources":["../../../src/__tests__/utils/testRequest.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,EAAE,UAAS,WAAgB,sBAQvE,CAAC"}

package/dist/__tests__/utils/testRequest.js

@@ -1,11 +0,0 @@
-import app from '../../index';
-// Helper function to make requests with JSON headers
-export const makeRequest = async (url, options = {}) => {
-    return app.request(url, {
-        ...options,
-        headers: {
-            'Content-Type': 'application/json',
-            ...options.headers,
-        },
-    });
-};

package/dist/__tests__/utils/testTenant.d.ts

@@ -1,64 +0,0 @@
-/**
- * Creates a unique tenant ID for test isolation.
- *
- * Each test run gets its own tenant to ensure parallel tests don't interfere with each other.
- * The generated tenant ID follows the format: test-tenant-{prefix}-{uuid} or test-tenant-{uuid}
- *
- * @param prefix - Optional prefix to include in the tenant ID (e.g., test file name)
- * @returns A unique tenant ID for test isolation
- *
- * @example
- * ```typescript
- * import { createTestTenantId } from './utils/testTenant';
- *
- * describe('My test suite', () => {
- *   const tenantId = createTestTenantId('agents');
- *
- *   it('should work with isolated tenant', async () => {
- *     // Your test code using the unique tenant ID
- *     console.log(tenantId); // e.g., "test-tenant-agents-123e4567-e89b-12d3-a456-426614174000"
- *   });
- * });
- * ```
- */
-export declare function createTestTenantId(prefix?: string): string;
-/**
- * Creates multiple unique tenant IDs for test isolation.
- *
- * Useful when you need multiple tenants in a single test.
- *
- * @param count - Number of tenant IDs to generate
- * @param prefix - Optional prefix to include in all tenant IDs
- * @returns Array of unique tenant IDs
- *
- * @example
- * ```typescript
- * import { createTestTenantIds } from './utils/testTenant';
- *
- * describe('Multi-tenant test suite', () => {
- *   const [tenantA, tenantB] = createTestTenantIds(2, 'multi-tenant');
- *
- *   it('should handle cross-tenant operations', async () => {
- *     // Test operations across different tenants
- *   });
- * });
- * ```
- */
-export declare function createTestTenantIds(count: number, prefix?: string): string[];
-/**
- * Checks if a tenant ID is a test tenant.
- *
- * @param tenantId - The tenant ID to check
- * @returns True if the tenant ID is a test tenant
- *
- * @example
- * ```typescript
- * import { isTestTenant } from './utils/testTenant';
- *
- * const tenantId = createTestTenantId();
- * console.log(isTestTenant(tenantId)); // true
- * console.log(isTestTenant('production-tenant')); // false
- * ```
- */
-export declare function isTestTenant(tenantId: string): boolean;
-//# sourceMappingURL=testTenant.d.ts.map

package/dist/__tests__/utils/testTenant.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"testTenant.d.ts","sourceRoot":"","sources":["../../../src/__tests__/utils/testTenant.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/__tests__/utils/testTenant.js

@@ -1,71 +0,0 @@
-import { randomUUID } from 'node:crypto';
-/**
- * Creates a unique tenant ID for test isolation.
- *
- * Each test run gets its own tenant to ensure parallel tests don't interfere with each other.
- * The generated tenant ID follows the format: test-tenant-{prefix}-{uuid} or test-tenant-{uuid}
- *
- * @param prefix - Optional prefix to include in the tenant ID (e.g., test file name)
- * @returns A unique tenant ID for test isolation
- *
- * @example
- * ```typescript
- * import { createTestTenantId } from './utils/testTenant';
- *
- * describe('My test suite', () => {
- *   const tenantId = createTestTenantId('agents');
- *
- *   it('should work with isolated tenant', async () => {
- *     // Your test code using the unique tenant ID
- *     console.log(tenantId); // e.g., "test-tenant-agents-123e4567-e89b-12d3-a456-426614174000"
- *   });
- * });
- * ```
- */
-export function createTestTenantId(prefix) {
-    const uuid = randomUUID();
-    return prefix ? `test-tenant-${prefix}-${uuid}` : `test-tenant-${uuid}`;
-}
-/**
- * Creates multiple unique tenant IDs for test isolation.
- *
- * Useful when you need multiple tenants in a single test.
- *
- * @param count - Number of tenant IDs to generate
- * @param prefix - Optional prefix to include in all tenant IDs
- * @returns Array of unique tenant IDs
- *
- * @example
- * ```typescript
- * import { createTestTenantIds } from './utils/testTenant';
- *
- * describe('Multi-tenant test suite', () => {
- *   const [tenantA, tenantB] = createTestTenantIds(2, 'multi-tenant');
- *
- *   it('should handle cross-tenant operations', async () => {
- *     // Test operations across different tenants
- *   });
- * });
- * ```
- */
-export function createTestTenantIds(count, prefix) {
-    return Array.from({ length: count }, () => createTestTenantId(prefix));
-}
-/**
- * Checks if a tenant ID is a test tenant.
- *
- * @param tenantId - The tenant ID to check
- * @returns True if the tenant ID is a test tenant
- *
- * @example
- * ```typescript
- * import { isTestTenant } from './utils/testTenant';
- *
- * const tenantId = createTestTenantId();
- * console.log(isTestTenant(tenantId)); // true
- * console.log(isTestTenant('production-tenant')); // false
- * ```
- */
-export function isTestTenant(tenantId) {
-    return tenantId.startsWith('test-tenant-');
-}

package/dist/app.d.ts

@@ -1,5 +0,0 @@
-import { Hono } from 'hono';
-import type { CredentialStoreRegistry, ServerConfig } from '@inkeep/agents-core';
-declare function createManagementHono(serverConfig: ServerConfig, credentialStores: CredentialStoreRegistry): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
-export { createManagementHono };
-//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAkBjF,iBAAS,oBAAoB,CAC3B,YAAY,EAAE,YAAY,EAC1B,gBAAgB,EAAE,uBAAuB,8EAqK1C;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/app.js

@@ -1,151 +0,0 @@
-import { Hono } from 'hono';
-import { createRoute, OpenAPIHono } from '@hono/zod-openapi';
-import { handleApiError } from '@inkeep/agents-core';
-import { cors } from 'hono/cors';
-import { HTTPException } from 'hono/http-exception';
-import { requestId } from 'hono/request-id';
-import { pinoLogger } from 'hono-pino';
-import { getLogger } from './logger';
-import { apiKeyAuth } from './middleware/auth';
-import { setupOpenAPIRoutes } from './openapi';
-import crudRoutes from './routes/index';
-import oauthRoutes from './routes/oauth';
-function createManagementHono(serverConfig, credentialStores) {
-    const app = new OpenAPIHono();
-    // Request ID middleware
-    app.use('*', requestId());
-    // Server config and credential stores middleware
-    app.use('*', async (c, next) => {
-        c.set('serverConfig', serverConfig);
-        c.set('credentialStores', credentialStores);
-        return next();
-    });
-    // Logging middleware
-    app.use(pinoLogger({
-        pino: getLogger(),
-        http: {
-            onResLevel(c) {
-                if (c.res.status >= 500) {
-                    return 'error';
-                }
-                return 'info';
-            },
-        },
-    }));
-    // Error handling
-    app.onError(async (err, c) => {
-        const isExpectedError = err instanceof HTTPException;
-        const status = isExpectedError ? err.status : 500;
-        const requestId = c.get('requestId') || 'unknown';
-        // Zod validation error detection
-        let zodIssues;
-        if (err && typeof err === 'object') {
-            if (err.cause && Array.isArray(err.cause.issues)) {
-                zodIssues = err.cause.issues;
-            }
-            else if (Array.isArray(err.issues)) {
-                zodIssues = err.issues;
-            }
-        }
-        if (status === 400 && Array.isArray(zodIssues)) {
-            c.status(400);
-            c.header('Content-Type', 'application/problem+json');
-            c.header('X-Content-Type-Options', 'nosniff');
-            return c.json({
-                type: 'https://docs.inkeep.com/agents-api/errors#bad_request',
-                title: 'Validation Failed',
-                status: 400,
-                detail: 'Request validation failed',
-                errors: zodIssues.map((issue) => ({
-                    detail: issue.message,
-                    pointer: issue.path ? `/${issue.path.join('/')}` : undefined,
-                    name: issue.path ? issue.path.join('.') : undefined,
-                    reason: issue.message,
-                })),
-            });
-        }
-        if (status >= 500) {
-            if (!isExpectedError) {
-                const errorMessage = err instanceof Error ? err.message : String(err);
-                const errorStack = err instanceof Error ? err.stack : undefined;
-                getLogger().error({
-                    error: err,
-                    message: errorMessage,
-                    stack: errorStack,
-                    path: c.req.path,
-                    requestId,
-                }, 'Unexpected server error occurred');
-            }
-            else {
-                getLogger().error({
-                    error: err,
-                    path: c.req.path,
-                    requestId,
-                    status,
-                }, 'Server error occurred');
-            }
-        }
-        if (isExpectedError) {
-            try {
-                const response = err.getResponse();
-                return response;
-            }
-            catch (responseError) {
-                getLogger().error({ error: responseError }, 'Error while handling HTTPException response');
-            }
-        }
-        const { status: respStatus, title, detail, instance } = await handleApiError(err, requestId);
-        c.status(respStatus);
-        c.header('Content-Type', 'application/problem+json');
-        c.header('X-Content-Type-Options', 'nosniff');
-        return c.json({
-            type: 'https://docs.inkeep.com/agents-api/errors#internal_server_error',
-            title,
-            status: respStatus,
-            detail,
-            ...(instance && { instance }),
-        });
-    });
-    // CORS middleware
-    app.use('*', cors({
-        origin: (origin) => {
-            if (!origin)
-                return origin;
-            return origin.startsWith('http://localhost:') || origin.startsWith('https://localhost:')
-                ? origin
-                : null;
-        },
-        allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS', 'PATCH'],
-        allowHeaders: ['*'],
-        exposeHeaders: ['Content-Length'],
-        maxAge: 86400,
-        credentials: true,
-    }));
-    // Health check endpoint
-    app.openapi(createRoute({
-        method: 'get',
-        path: '/health',
-        tags: ['health'],
-        summary: 'Health check',
-        description: 'Check if the management service is healthy',
-        responses: {
-            204: {
-                description: 'Service is healthy',
-            },
-        },
-    }), (c) => {
-        return c.body(null, 204);
-    });
-    // API Key authentication middleware for protected routes
-    app.use('/tenants/*', apiKeyAuth());
-    // Mount CRUD routes for all entities
-    app.route('/tenants/:tenantId/crud', crudRoutes);
-    // Mount OAuth routes - global OAuth callback endpoint
-    app.route('/oauth', oauthRoutes);
-    // Setup OpenAPI documentation endpoints (/openapi.json and /docs)
-    setupOpenAPIRoutes(app);
-    const baseApp = new Hono();
-    baseApp.route('/', app);
-    return baseApp;
-}
-export { createManagementHono };

package/dist/data/conversations.d.ts

@@ -1,59 +0,0 @@
-import { type AgentConversationHistoryConfig, type ConversationHistoryConfig, type ConversationScopeOptions } from '@inkeep/agents-core';
-/**
- * Creates default conversation history configuration
- * @param mode - The conversation history mode ('full' | 'scoped' | 'none')
- * @returns Default AgentConversationHistoryConfig
- */
-export declare function createDefaultConversationHistoryConfig(mode?: 'full' | 'scoped' | 'none'): AgentConversationHistoryConfig;
-/**
- * Saves the result of an A2A client sendMessage call as a conversation message
- * @param response - The response from a2aClient.sendMessage()
- * @param params - Parameters for saving the message
- * @returns The saved message or null if no text content was found
- */
-export declare function saveA2AMessageResponse(response: any, // SendMessageResponse type
-params: {
-    tenantId: string;
-    projectId: string;
-    conversationId: string;
-    messageType: 'a2a-response' | 'a2a-request';
-    visibility: 'internal' | 'external' | 'user-facing';
-    fromAgentId?: string;
-    toAgentId?: string;
-    fromExternalAgentId?: string;
-    toExternalAgentId?: string;
-    a2aTaskId?: string;
-    a2aSessionId?: string;
-    metadata?: Record<string, unknown>;
-}): Promise<any | null>;
-/**
- * Applies filtering based on agent, task, or both criteria
- * Returns the filtered messages array
- */
-export declare function getScopedHistory({ tenantId, projectId, conversationId, filters, options, }: {
-    tenantId: string;
-    projectId: string;
-    conversationId: string;
-    filters?: ConversationScopeOptions;
-    options?: ConversationHistoryConfig;
-}): Promise<any[]>;
-/**
- * Get user-facing conversation history (for client display)
- */
-export declare function getUserFacingHistory(tenantId: string, projectId: string, conversationId: string, limit?: number): Promise<any[]>;
-/**
- * Get full conversation context (for agent processing)
- */
-export declare function getFullConversationContext(tenantId: string, projectId: string, conversationId: string, maxTokens?: number): Promise<any[]>;
-/**
- * Get formatted conversation history for a2a
- */
-export declare function getFormattedConversationHistory({ tenantId, projectId, conversationId, currentMessage, options, filters, }: {
-    tenantId: string;
-    projectId: string;
-    conversationId: string;
-    currentMessage?: string;
-    options?: ConversationHistoryConfig;
-    filters?: ConversationScopeOptions;
-}): Promise<string>;
-//# sourceMappingURL=conversations.d.ts.map

package/dist/data/conversations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/data/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAG9B,MAAM,qBAAqB,CAAC;AAI7B;;;;GAIG;AACH,wBAAgB,sCAAsC,CACpD,IAAI,GAAE,MAAM,GAAG,QAAQ,GAAG,MAAe,GACxC,8BAA8B,CAQhC;AAYD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,GAAG,EAAE,2BAA2B;AAC1C,MAAM,EAAE;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,cAAc,GAAG,aAAa,CAAC;IAC5C,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GACA,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAkDrB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,QAAQ,EACR,SAAS,EACT,cAAc,EACd,OAAO,EACP,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACrC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAyDjB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,KAAK,SAAK,GACT,OAAO,CAAC,GAAG,EAAE,CAAC,CAUhB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,GAAG,EAAE,CAAC,CAUhB;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,EACpD,QAAQ,EACR,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDlB"}