@kraken-ai/platform 0.0.1 → 0.0.2

package/dist/types-CkknNKNr.d.ts

@@ -0,0 +1,451 @@
+import * as z from 'zod';
+import { ModelString } from 'kraken-ai';
+
+/** MCP tool annotations per the MCP spec (v1.27.1) */
+interface ToolAnnotations {
+    readonly readOnlyHint?: boolean;
+    readonly destructiveHint?: boolean;
+    readonly idempotentHint?: boolean;
+    readonly openWorldHint?: boolean;
+}
+/** Explicit MCP content pass-through (returned by mcpResult() helper) */
+interface McpContent {
+    readonly __mcpPassThrough: true;
+    readonly content: ReadonlyArray<{
+        readonly type: string;
+        [key: string]: unknown;
+    }>;
+    readonly isError?: boolean;
+}
+/**
+ * Union of valid handler return types.
+ * Prevents returning unsupported types at compile time.
+ */
+type ConnectorHandlerResult = string | number | boolean | Record<string, unknown> | ReadonlyArray<unknown> | McpContent | null | undefined;
+/** Minimal context passed to resource/prompt handlers — business logic only */
+interface ConnectorHandlerContext {
+    readonly signal: AbortSignal;
+}
+/** MCP-native resource content (text or binary) */
+type ResourceContent = {
+    readonly uri: string;
+    readonly mimeType?: string;
+    readonly text: string;
+} | {
+    readonly uri: string;
+    readonly mimeType?: string;
+    readonly blob: string;
+};
+/** MCP-native ReadResourceResult — returned by resource read handlers */
+interface ReadResourceResult {
+    readonly contents: ReadonlyArray<ResourceContent>;
+}
+/** MCP-native prompt message content */
+type PromptMessageContent = {
+    readonly type: "text";
+    readonly text: string;
+} | {
+    readonly type: "image";
+    readonly data: string;
+    readonly mimeType: string;
+};
+/** MCP-native GetPromptResult — returned by prompt get handlers */
+interface GetPromptResult {
+    readonly description?: string;
+    readonly messages: ReadonlyArray<{
+        readonly role: "user" | "assistant";
+        readonly content: PromptMessageContent;
+    }>;
+}
+/** A tool definition within a connector */
+interface ConnectorToolDef<TInput extends z.ZodType = z.ZodType> {
+    readonly description: string;
+    readonly input: TInput;
+    readonly annotations?: ToolAnnotations;
+    handler(args: z.infer<TInput>): Promise<ConnectorHandlerResult> | ConnectorHandlerResult;
+}
+/** A resource definition within a connector */
+interface ConnectorResourceDef {
+    readonly description: string;
+    readonly uri: string;
+    readonly mimeType?: string;
+    read(ctx: ConnectorHandlerContext): Promise<ReadResourceResult> | ReadResourceResult;
+}
+/** A prompt definition within a connector */
+interface ConnectorPromptDef {
+    readonly description: string;
+    readonly arguments?: ReadonlyArray<{
+        readonly name: string;
+        readonly description?: string;
+        readonly required?: boolean;
+    }>;
+    get(args: Record<string, string>, ctx: ConnectorHandlerContext): Promise<GetPromptResult> | GetPromptResult;
+}
+/** Input to defineConnector() */
+interface ConnectorDefinition {
+    readonly name: string;
+    readonly description?: string;
+    readonly instructions?: string;
+    readonly tools?: Record<string, ConnectorToolDef>;
+    readonly resources?: Record<string, ConnectorResourceDef>;
+    readonly prompts?: Record<string, ConnectorPromptDef>;
+}
+/** Output of defineConnector() — frozen, carries handlers for server builder */
+interface PlatformConnector {
+    readonly __type: "PlatformConnector";
+    readonly name: string;
+    readonly description?: string;
+    readonly instructions?: string;
+    readonly tools?: Readonly<Record<string, ConnectorToolDef>>;
+    readonly resources?: Readonly<Record<string, ConnectorResourceDef>>;
+    readonly prompts?: Readonly<Record<string, ConnectorPromptDef>>;
+}
+
+/** Action names follow entity naming convention: lowercase alphanumeric with hyphens, 1-64 chars. */
+declare const ACTION_NAME_REGEX: RegExp;
+/** Validates an action name (allows single-char names like "a"). */
+declare const isValidActionName: (name: string) => boolean;
+/** Input for a single action variant in defineActions(). */
+interface ActionVariantInput<S extends z.ZodObject<z.ZodRawShape> = z.ZodObject<z.ZodRawShape>> {
+    schema: S;
+    webhook?: string;
+    handler?(payload: z.infer<S>): Promise<void>;
+}
+/** Serializable config for a single action variant (stored in manifest/DB). */
+interface ActionVariantConfig {
+    schema: Record<string, unknown>;
+    webhook?: string;
+    hasHandler: boolean;
+}
+/** Serializable portion of action definitions (stored in agent config). */
+interface PlatformActionsConfig {
+    variants: Record<string, ActionVariantConfig>;
+}
+/** Full action definitions including in-memory schemas and handlers for runtime use. */
+interface PlatformActions {
+    readonly __type: "PlatformActions";
+    readonly config: PlatformActionsConfig;
+    readonly zodSchemas: Record<string, z.ZodObject<z.ZodRawShape>>;
+    readonly handlers: Readonly<Record<string, (payload: unknown) => Promise<void>>>;
+}
+declare const actionVariantConfigSchema: z.ZodObject<{
+    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    webhook: z.ZodOptional<z.ZodString>;
+    hasHandler: z.ZodBoolean;
+}, z.core.$strip>;
+declare const actionsConfigSchema: z.ZodObject<{
+    variants: z.ZodRecord<z.ZodString, z.ZodObject<{
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        webhook: z.ZodOptional<z.ZodString>;
+        hasHandler: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+
+/**
+ * Type registry populated by `kraken generate` via module augmentation.
+ *
+ * Before generating, all ID types resolve to an error-message string —
+ * only local typed refs (PlatformAgent, PlatformSkill, PlatformConnector) compile.
+ *
+ * After `kraken generate`, the generated `.kraken-ai/platform-types.d.ts` augments
+ * this interface with `agentId`, `connectorId`, and `skillId` string unions,
+ * enabling autocomplete on remote IDs.
+ *
+ * @example
+ * ```ts
+ * // .kraken-ai/platform-types.d.ts (generated)
+ * declare module "@kraken-ai/platform" {
+ *   interface KrakenTypeRegistry {
+ *     agentId: "analyst" | "writer";
+ *     connectorId: "slack" | "jira";
+ *     skillId: "competitor-deep-dive";
+ *   }
+ * }
+ * ```
+ */
+interface KrakenTypeRegistry {
+}
+/** Remote agent IDs. Resolves to an error hint before `kraken generate`. */
+type AgentId = KrakenTypeRegistry extends {
+    agentId: infer T extends string;
+} ? T : "ERROR: Run 'kraken generate' to unlock agent IDs";
+/** Remote connector IDs. Resolves to an error hint before `kraken generate`. */
+type ConnectorId = KrakenTypeRegistry extends {
+    connectorId: infer T extends string;
+} ? T : "ERROR: Run 'kraken generate' to unlock connector IDs";
+/** Remote skill IDs. Resolves to an error hint before `kraken generate`. */
+type SkillId = KrakenTypeRegistry extends {
+    skillId: infer T extends string;
+} ? T : "ERROR: Run 'kraken generate' to unlock skill IDs";
+
+declare const agentDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    model: z.ZodString;
+    instructions: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    allowTemperatureOverride: z.ZodOptional<z.ZodBoolean>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    thinkingLevel: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    logLevel: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        silent: "silent";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+    }>>;
+}, z.core.$strict>;
+type AgentDefinition = Omit<z.infer<typeof agentDefinitionSchema>, "model"> & {
+    model: ModelString;
+};
+declare const platformAgentConfigSchema: z.ZodObject<{
+    agent: z.ZodObject<{
+        name: z.ZodString;
+        model: z.ZodString;
+        instructions: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        allowTemperatureOverride: z.ZodOptional<z.ZodBoolean>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        thinkingLevel: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        logLevel: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            silent: "silent";
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+        }>>;
+    }, z.core.$strict>;
+    connectors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    trigger: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"cron">;
+        expression: z.ZodString;
+        timezone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"webhook">;
+        path: z.ZodString;
+        method: z.ZodOptional<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"event">;
+        source: z.ZodString;
+        event: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"api">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"manual">;
+    }, z.core.$strip>], "type">;
+    identity: z.ZodOptional<z.ZodObject<{
+        basePermissions: z.ZodArray<z.ZodString>;
+        requestablePermissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        jitPolicy: z.ZodOptional<z.ZodEnum<{
+            "auto-approve": "auto-approve";
+            "policy-based": "policy-based";
+            "require-approval": "require-approval";
+        }>>;
+        maxJitDurationMinutes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    resources: z.ZodOptional<z.ZodObject<{
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        maxCostUsd: z.ZodOptional<z.ZodNumber>;
+        timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    retries: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        backoffSeconds: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    concurrency: z.ZodOptional<z.ZodObject<{
+        maxParallelRuns: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    team: z.ZodOptional<z.ZodObject<{
+        members: z.ZodArray<z.ZodString>;
+        maxConcurrentWorkers: z.ZodOptional<z.ZodNumber>;
+        maxTokenBudgetPerWorker: z.ZodOptional<z.ZodNumber>;
+        maxDurationPerWorker: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    notifications: z.ZodOptional<z.ZodObject<{
+        slack: z.ZodOptional<z.ZodString>;
+        onSuccess: z.ZodOptional<z.ZodBoolean>;
+        onFailure: z.ZodOptional<z.ZodBoolean>;
+        onTimeout: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    environment: z.ZodOptional<z.ZodEnum<{
+        dev: "dev";
+        staging: "staging";
+        prod: "prod";
+    }>>;
+    actions: z.ZodOptional<z.ZodObject<{
+        variants: z.ZodRecord<z.ZodString, z.ZodObject<{
+            schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            webhook: z.ZodOptional<z.ZodString>;
+            hasHandler: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type PlatformAgentConfig = Omit<z.infer<typeof platformAgentConfigSchema>, "agent" | "actions"> & {
+    agent: AgentDefinition;
+    actions?: PlatformActionsConfig;
+};
+interface PlatformAgent {
+    readonly __type: "PlatformAgent";
+    readonly config: PlatformAgentConfig;
+    readonly runtime?: unknown;
+    /** In-memory schemas for action variants. Not serialized — runtime use only. */
+    readonly actionZodSchemas?: Record<string, z.ZodObject<z.ZodRawShape>>;
+    /** Action handler functions. Not serialized — runtime use only. */
+    readonly actionHandlers?: Readonly<Record<string, (payload: unknown) => Promise<void>>>;
+    /** Team member PlatformAgent objects. Not serialized — runtime use only (dev mode delegation). */
+    readonly teamAgents?: readonly PlatformAgent[];
+}
+/** Team member reference: local PlatformAgent or remote AgentId string. */
+type TeamMember = PlatformAgent | AgentId;
+
+interface PlatformClientConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+interface PaginationParams {
+    cursor?: string;
+    limit?: number;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    cursor: string | null;
+    hasMore: boolean;
+}
+type AgentEvent = {
+    type: "text";
+    content: string;
+} | {
+    type: "tool_call";
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: "tool_result";
+    name: string;
+    result: unknown;
+} | {
+    type: "thinking";
+    content: string;
+} | {
+    type: "action";
+    name: string;
+    payload: Record<string, unknown>;
+    actionExecutionId: string;
+} | {
+    type: "done";
+    output: string;
+    usage?: {
+        tokens: number;
+    };
+} | {
+    type: "error";
+    message: string;
+    code: string;
+};
+interface AgentInfo {
+    id: string;
+    name: string;
+    description?: string;
+}
+interface ThreadInfo {
+    id: string;
+    agentId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ThreadMessage {
+    id: string;
+    threadId: string;
+    role: "user" | "assistant";
+    content: string;
+    toolCalls?: Array<{
+        name: string;
+        args: Record<string, unknown>;
+        result: unknown;
+    }>;
+    createdAt: string;
+    usage?: {
+        tokens: number;
+    };
+}
+interface QueryInfo {
+    name: string;
+    description?: string;
+    params: Record<string, unknown>;
+    columns: QueryColumn[];
+}
+interface QueryColumn {
+    name: string;
+    type: string;
+    description?: string;
+}
+interface QueryResult<TRow = Record<string, unknown>> {
+    rows: TRow[];
+    cursor: string | null;
+    hasMore: boolean;
+}
+type RunState = "QUEUED" | "PROVISIONING" | "RUNNING" | "DRAINING" | "COMPLETED" | "FAILED" | "AWAITING_APPROVAL" | "RETRYING";
+interface RunRecord {
+    runId: string;
+    agentId: string;
+    input: string;
+    state: RunState;
+    exitCode?: number;
+    createdAt: string;
+    updatedAt: string;
+    retryCount: number;
+    error?: string;
+}
+interface StartRunParams {
+    agentId: string;
+    tag?: string;
+    environment?: "dev" | "staging" | "prod";
+    input: string;
+    connectors?: string[];
+    envVars?: Record<string, string>;
+}
+interface RunEvent {
+    eventId: string;
+    eventType: string;
+    payload: Record<string, unknown>;
+}
+interface AgentSchema {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+    output: Record<string, unknown>;
+    actions?: Record<string, Record<string, unknown>>;
+}
+interface QuerySchema {
+    name: string;
+    params: Record<string, unknown>;
+    columns: QueryColumn[];
+}
+interface ConnectorSchema {
+    id: string;
+    tools: Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+}
+interface SkillSchema {
+    id: string;
+    name: string;
+    description?: string;
+}
+
+export { type ActionVariantInput as A, type PromptMessageContent as B, type ConnectorId as C, type QueryColumn as D, type QuerySchema as E, type ReadResourceResult as F, type GetPromptResult as G, type ResourceContent as H, type RunState as I, type SkillSchema as J, type KrakenTypeRegistry as K, type ToolAnnotations as L, type McpContent as M, actionVariantConfigSchema as N, actionsConfigSchema as O, type PlatformConnector as P, type QueryInfo as Q, type RunRecord as R, type SkillId as S, type TeamMember as T, agentDefinitionSchema as U, isValidActionName as V, platformAgentConfigSchema as W, type PlatformAgentConfig as a, type PlatformActions as b, type PlatformAgent as c, type ConnectorDefinition as d, type ConnectorToolDef as e, type PlatformClientConfig as f, type AgentEvent as g, type PaginationParams as h, type PaginatedResponse as i, type ThreadMessage as j, type AgentInfo as k, type ThreadInfo as l, type QueryResult as m, type StartRunParams as n, type RunEvent as o, ACTION_NAME_REGEX as p, type ActionVariantConfig as q, type AgentDefinition as r, type AgentId as s, type AgentSchema as t, type ConnectorHandlerContext as u, type ConnectorHandlerResult as v, type ConnectorPromptDef as w, type ConnectorResourceDef as x, type ConnectorSchema as y, type PlatformActionsConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kraken-ai/platform",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Kraken AI Platform SDK — PlatformClient and kraken CLI",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -21,10 +21,17 @@
   "bin": {
     "kraken": "./dist/cli.js"
   },
+  "scripts": {
+    "build": "tsup && chmod +x dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "tsc --noEmit && biome check",
+    "check:write": "biome check --write"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "zod": "^4.3.6",
-    "kraken-ai": "0.0.3"
+    "kraken-ai": "workspace:*",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
@@ -35,12 +42,5 @@
   "files": [
     "dist"
   ],
-  "license": "BUSL-1.1",
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "check": "biome check && tsc --noEmit",
-    "check:write": "biome check --write"
-  }
-}
+  "license": "BUSL-1.1"
+}

package/dist/chunk-HGJSK6MW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/agents/errors.ts","../src/agents/connector-wrap.ts","../src/agents/connector-server.ts"],"sourcesContent":["// Copyright (c) Optima Engineering LLC\n// SPDX-License-Identifier: BUSL-1.1\n\nexport class SecurityError extends Error {\n  readonly code = \"SECURITY_VIOLATION\";\n\n  constructor(message: string) {\n    super(message);\n    this.name = \"SecurityError\";\n  }\n}\n\nexport class ConnectorError extends Error {\n  readonly code = \"CONNECTOR_ERROR\";\n\n  constructor(message: string) {\n    super(message);\n    this.name = \"ConnectorError\";\n  }\n}\n","// Copyright (c) Optima Engineering LLC\n// SPDX-License-Identifier: BUSL-1.1\n\nimport { ConnectorError } from \"./errors\";\nimport type { McpContent } from \"./types/connector\";\n\nconst MAX_TOOL_RESULT_SIZE = 10 * 1024 * 1024; // 10MB\n\ninterface ToolResultContent {\n  readonly type: string;\n  [key: string]: unknown;\n}\n\ninterface ToolResult {\n  readonly content: ReadonlyArray<ToolResultContent>;\n  readonly isError?: boolean;\n}\n\nconst isMcpContent = (val: unknown): val is McpContent =>\n  typeof val === \"object\" &&\n  val !== null &&\n  \"__mcpPassThrough\" in val &&\n  (val as McpContent).__mcpPassThrough === true;\n\n/** Wrap a handler return value into MCP CallToolResult format */\nexport const wrapToolResult = (value: unknown): ToolResult => {\n  if (value === null || value === undefined) {\n    return { content: [] };\n  }\n\n  if (typeof value === \"string\") {\n    return { content: [{ type: \"text\", text: value }] };\n  }\n\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return { content: [{ type: \"text\", text: String(value) }] };\n  }\n\n  if (isMcpContent(value)) {\n    const result: ToolResult = { content: value.content };\n    if (value.isError) {\n      return { ...result, isError: true };\n    }\n    return result;\n  }\n\n  const json = JSON.stringify(value, null, 2);\n  if (json.length > MAX_TOOL_RESULT_SIZE) {\n    return {\n      content: [{ type: \"text\", text: `[Result truncated: ${json.length} bytes]` }],\n      isError: true,\n    };\n  }\n  return { content: [{ type: \"text\", text: json }] };\n};\n\n/** Wrap a thrown error into MCP CallToolResult format with isError: true */\nexport const wrapToolError = (error: unknown): ToolResult => {\n  if (error instanceof ConnectorError) {\n    return {\n      content: [{ type: \"text\", text: error.message }],\n      isError: true,\n    };\n  }\n\n  if (error instanceof Error) {\n    console.error(\"[connector] Internal handler error:\", error.message, error.stack);\n  } else {\n    console.error(\"[connector] Internal handler error:\", String(error));\n  }\n\n  return {\n    content: [{ type: \"text\", text: \"Internal handler error\" }],\n    isError: true,\n  };\n};\n\n/** Create an explicit MCP content pass-through result */\nexport const mcpResult = (content: McpContent[\"content\"], isError?: boolean): McpContent => ({\n  __mcpPassThrough: true as const,\n  content,\n  isError,\n});\n","// Copyright (c) Optima Engineering LLC\n// SPDX-License-Identifier: BUSL-1.1\n\nimport { randomUUID } from \"node:crypto\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport type { AddressInfo } from \"node:net\";\n\nimport * as z from \"zod\";\nimport { wrapToolError, wrapToolResult } from \"./connector-wrap\";\nimport type { ConnectorPromptDef, PlatformConnector } from \"./types/connector\";\n\nconst DEFAULT_HANDLER_TIMEOUT_MS = 30_000;\nconst MAX_BODY_SIZE = 10 * 1024 * 1024; // 10MB\n\nexport interface ConnectorServerOptions {\n  readonly port?: number;\n  readonly host?: string;\n  readonly handlerTimeoutMs?: number;\n}\n\nexport interface ConnectorServerHandle {\n  readonly port: number;\n  readonly close: () => Promise<void>;\n}\n\nconst withTimeout = <T>(promise: Promise<T>, ms: number): Promise<T> =>\n  Promise.race([\n    promise,\n    new Promise<never>((_, reject) =>\n      setTimeout(() => reject(new Error(`Handler timed out after ${ms}ms`)), ms),\n    ),\n  ]);\n\nconst readBody = (req: IncomingMessage, maxSize: number): Promise<string> =>\n  new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    let size = 0;\n    req.on(\"data\", (chunk: Buffer) => {\n      size += chunk.length;\n      if (size > maxSize) {\n        req.destroy();\n        reject(new Error(\"Request body too large\"));\n        return;\n      }\n      chunks.push(chunk);\n    });\n    req.on(\"end\", () => resolve(Buffer.concat(chunks).toString()));\n    req.on(\"error\", reject);\n  });\n\n/** Convert ConnectorPromptDef.arguments array to a raw shape for MCP SDK */\nconst buildPromptArgsSchema = (\n  def: ConnectorPromptDef,\n): Record<string, z.ZodString | z.ZodOptional<z.ZodString>> | undefined => {\n  if (!def.arguments?.length) return undefined;\n  const shape: Record<string, z.ZodString | z.ZodOptional<z.ZodString>> = {};\n  for (const arg of def.arguments) {\n    shape[arg.name] = arg.required ? z.string() : z.string().optional();\n  }\n  return shape;\n};\n\nexport const startConnectorServer = async (\n  connector: PlatformConnector,\n  options?: ConnectorServerOptions,\n): Promise<ConnectorServerHandle> => {\n  const mcpServerModule = await import(\"@modelcontextprotocol/sdk/server/mcp.js\").catch(() => {\n    throw new Error(\n      \"@modelcontextprotocol/sdk is required for startConnectorServer. \" +\n        \"Install it: pnpm add @modelcontextprotocol/sdk\",\n    );\n  });\n  const transportModule = await import(\"@modelcontextprotocol/sdk/server/streamableHttp.js\").catch(\n    () => {\n      throw new Error(\n        \"@modelcontextprotocol/sdk is required for startConnectorServer. \" +\n          \"Install it: pnpm add @modelcontextprotocol/sdk\",\n      );\n    },\n  );\n\n  const { McpServer } = mcpServerModule;\n  const { StreamableHTTPServerTransport } = transportModule;\n\n  const timeoutMs = options?.handlerTimeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS;\n\n  const mcpServer = new McpServer(\n    { name: connector.name, version: \"0.0.0\" },\n    { capabilities: { tools: {}, resources: {}, prompts: {} } },\n  );\n\n  const tools = connector.tools ?? {};\n  const toolEntries = Object.entries(tools);\n\n  if (toolEntries.length === 0) {\n    console.warn(\n      `[connector:${connector.name}] No tools defined — server will start with zero tools`,\n    );\n  }\n\n  for (const [name, def] of toolEntries) {\n    mcpServer.registerTool(\n      name,\n      {\n        description: def.description,\n        inputSchema: def.input,\n        ...(def.annotations ? { annotations: def.annotations } : {}),\n      },\n      async (args: unknown) => {\n        try {\n          // args is already validated by the MCP SDK against the Zod schema\n          const result = await withTimeout(Promise.resolve(def.handler(args)), timeoutMs);\n          const wrapped = wrapToolResult(result);\n          return {\n            content: wrapped.content.map((c) => ({\n              type: \"text\" as const,\n              text: String(\"text\" in c ? c.text : \"\"),\n            })),\n            ...(wrapped.isError === true ? { isError: true as const } : {}),\n          };\n        } catch (error: unknown) {\n          const wrapped = wrapToolError(error);\n          return {\n            content: wrapped.content.map((c) => ({\n              type: \"text\" as const,\n              text: String(\"text\" in c ? c.text : \"\"),\n            })),\n            isError: true as const,\n          };\n        }\n      },\n    );\n  }\n\n  const resources = connector.resources ?? {};\n  for (const [name, def] of Object.entries(resources)) {\n    mcpServer.registerResource(\n      name,\n      def.uri,\n      {\n        description: def.description,\n        ...(def.mimeType ? { mimeType: def.mimeType } : {}),\n      },\n      async (_uri: URL, extra: { signal: AbortSignal }) => {\n        try {\n          const result = await withTimeout(\n            Promise.resolve(def.read({ signal: extra.signal })),\n            timeoutMs,\n          );\n          return { contents: [...result.contents] };\n        } catch (error: unknown) {\n          if (error instanceof Error) {\n            console.error(`[connector:${connector.name}] Resource read error:`, error.message);\n          }\n          throw error;\n        }\n      },\n    );\n  }\n\n  const prompts = connector.prompts ?? {};\n  for (const [name, def] of Object.entries(prompts)) {\n    const argsSchema = buildPromptArgsSchema(def);\n    mcpServer.registerPrompt(\n      name,\n      {\n        description: def.description,\n        ...(argsSchema ? { argsSchema } : {}),\n      },\n      async (args: Record<string, string | undefined>, extra: { signal: AbortSignal }) => {\n        try {\n          const cleanArgs: Record<string, string> = {};\n          for (const [k, v] of Object.entries(args)) {\n            if (v !== undefined) cleanArgs[k] = v;\n          }\n          const result = await withTimeout(\n            Promise.resolve(def.get(cleanArgs, { signal: extra.signal })),\n            timeoutMs,\n          );\n          return { messages: [...result.messages] };\n        } catch (error: unknown) {\n          if (error instanceof Error) {\n            console.error(`[connector:${connector.name}] Prompt get error:`, error.message);\n          }\n          throw error;\n        }\n      },\n    );\n  }\n\n  const transport = new StreamableHTTPServerTransport({\n    sessionIdGenerator: () => randomUUID(),\n  });\n\n  const host = options?.host ?? \"127.0.0.1\";\n  const port = options?.port ?? 0;\n\n  const httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n    if (req.url === \"/health\" && req.method === \"GET\") {\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ status: \"ok\" }));\n      return;\n    }\n\n    if (\n      req.url === \"/mcp\" &&\n      (req.method === \"POST\" || req.method === \"GET\" || req.method === \"DELETE\")\n    ) {\n      if (req.method === \"POST\") {\n        // Check Content-Length before reading body (fast reject for oversized payloads)\n        const contentLength = parseInt(req.headers[\"content-length\"] ?? \"0\", 10);\n        if (contentLength > MAX_BODY_SIZE) {\n          req.resume(); // drain the request body to prevent EPIPE\n          res.writeHead(413, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Request body too large\" }));\n          return;\n        }\n\n        try {\n          const body = await readBody(req, MAX_BODY_SIZE);\n          const parsed: unknown = JSON.parse(body);\n          await transport.handleRequest(req, res, parsed);\n        } catch (err: unknown) {\n          if (!res.headersSent) {\n            const isTooLarge = err instanceof Error && err.message === \"Request body too large\";\n            res.writeHead(isTooLarge ? 413 : 400, { \"Content-Type\": \"application/json\" });\n            res.end(\n              JSON.stringify({\n                error: isTooLarge ? \"Request body too large\" : \"Invalid request body\",\n              }),\n            );\n          }\n        }\n        return;\n      }\n\n      // GET (SSE) and DELETE (session end)\n      try {\n        await transport.handleRequest(req, res);\n      } catch {\n        if (!res.headersSent) {\n          res.writeHead(500, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Internal server error\" }));\n        }\n      }\n      return;\n    }\n\n    res.writeHead(404);\n    res.end(\"Not found\");\n  });\n\n  // Connect MCP server to transport AFTER tool registration\n  await mcpServer.connect(transport);\n\n  await new Promise<void>((resolve) => {\n    httpServer.listen(port, host, () => resolve());\n  });\n\n  const addr = httpServer.address();\n  if (!addr || typeof addr === \"string\") {\n    throw new Error(\"Failed to get server address\");\n  }\n\n  return {\n    port: (addr as AddressInfo).port,\n    close: async () => {\n      await mcpServer.close();\n      await new Promise<void>((resolve, reject) => {\n        httpServer.close((err) => (err ? reject(err) : resolve()));\n      });\n    },\n  };\n};\n"],"mappings":"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","names":[]}

package/dist/connector-CumEDPfS.d.cts

@@ -1,103 +0,0 @@
-import * as z from 'zod';
-
-/** MCP tool annotations per the MCP spec (v1.27.1) */
-interface ToolAnnotations {
-    readonly readOnlyHint?: boolean;
-    readonly destructiveHint?: boolean;
-    readonly idempotentHint?: boolean;
-    readonly openWorldHint?: boolean;
-}
-/** Explicit MCP content pass-through (returned by mcpResult() helper) */
-interface McpContent {
-    readonly __mcpPassThrough: true;
-    readonly content: ReadonlyArray<{
-        readonly type: string;
-        [key: string]: unknown;
-    }>;
-    readonly isError?: boolean;
-}
-/**
- * Union of valid handler return types.
- * Prevents returning unsupported types at compile time.
- */
-type ConnectorHandlerResult = string | number | boolean | Record<string, unknown> | ReadonlyArray<unknown> | McpContent | null | undefined;
-/** Minimal context passed to resource/prompt handlers — business logic only */
-interface ConnectorHandlerContext {
-    readonly signal: AbortSignal;
-}
-/** MCP-native resource content (text or binary) */
-type ResourceContent = {
-    readonly uri: string;
-    readonly mimeType?: string;
-    readonly text: string;
-} | {
-    readonly uri: string;
-    readonly mimeType?: string;
-    readonly blob: string;
-};
-/** MCP-native ReadResourceResult — returned by resource read handlers */
-interface ReadResourceResult {
-    readonly contents: ReadonlyArray<ResourceContent>;
-}
-/** MCP-native prompt message content */
-type PromptMessageContent = {
-    readonly type: "text";
-    readonly text: string;
-} | {
-    readonly type: "image";
-    readonly data: string;
-    readonly mimeType: string;
-};
-/** MCP-native GetPromptResult — returned by prompt get handlers */
-interface GetPromptResult {
-    readonly description?: string;
-    readonly messages: ReadonlyArray<{
-        readonly role: "user" | "assistant";
-        readonly content: PromptMessageContent;
-    }>;
-}
-/** A tool definition within a connector */
-interface ConnectorToolDef<TInput extends z.ZodType = z.ZodType> {
-    readonly description: string;
-    readonly input: TInput;
-    readonly annotations?: ToolAnnotations;
-    handler(args: z.infer<TInput>): Promise<ConnectorHandlerResult> | ConnectorHandlerResult;
-}
-/** A resource definition within a connector */
-interface ConnectorResourceDef {
-    readonly description: string;
-    readonly uri: string;
-    readonly mimeType?: string;
-    read(ctx: ConnectorHandlerContext): Promise<ReadResourceResult> | ReadResourceResult;
-}
-/** A prompt definition within a connector */
-interface ConnectorPromptDef {
-    readonly description: string;
-    readonly arguments?: ReadonlyArray<{
-        readonly name: string;
-        readonly description?: string;
-        readonly required?: boolean;
-    }>;
-    get(args: Record<string, string>, ctx: ConnectorHandlerContext): Promise<GetPromptResult> | GetPromptResult;
-}
-/** Input to defineConnector() */
-interface ConnectorDefinition {
-    readonly name: string;
-    readonly description?: string;
-    readonly instructions?: string;
-    readonly tools?: Record<string, ConnectorToolDef>;
-    readonly resources?: Record<string, ConnectorResourceDef>;
-    readonly prompts?: Record<string, ConnectorPromptDef>;
-}
-/** Output of defineConnector() — frozen, carries handlers for server builder */
-interface PlatformConnector {
-    readonly __type: "PlatformConnector";
-    readonly name: string;
-    readonly description?: string;
-    readonly instructions?: string;
-    readonly tools?: Readonly<Record<string, ConnectorToolDef>>;
-    readonly resources?: Readonly<Record<string, ConnectorResourceDef>>;
-    readonly prompts?: Readonly<Record<string, ConnectorPromptDef>>;
-}
-
-export type { ConnectorDefinition as C, GetPromptResult as G, McpContent as M, PlatformConnector as P, ReadResourceResult as R, ToolAnnotations as T, ConnectorToolDef as a, ConnectorHandlerContext as b, ConnectorHandlerResult as c, ConnectorPromptDef as d, ConnectorResourceDef as e, PromptMessageContent as f, ResourceContent as g };