@kb-labs/gateway-contracts 0.2.0

package/dist/index.js

@@ -0,0 +1,417 @@
+import { z } from 'zod';
+
+// src/config.ts
+var UpstreamConfigSchema = z.object({
+  url: z.string().url(),
+  prefix: z.string().startsWith("/"),
+  /** Strip prefix before forwarding. Default: keep prefix as-is. Use "" to strip. */
+  rewritePrefix: z.string().optional(),
+  /** Enable WebSocket proxying for this upstream. Default: false. */
+  websocket: z.boolean().optional(),
+  /** Paths under this prefix that are NOT proxied (handled by gateway itself). */
+  excludePaths: z.array(z.string()).optional(),
+  description: z.string().optional()
+});
+var StaticTokenEntrySchema = z.object({
+  hostId: z.string(),
+  namespaceId: z.string()
+});
+var GatewayConfigSchema = z.object({
+  port: z.number().default(4e3),
+  upstreams: z.record(z.string(), UpstreamConfigSchema).default({}),
+  /** Static tokens seeded into ICache at bootstrap — for dev/service tokens before full auth */
+  staticTokens: z.record(z.string(), StaticTokenEntrySchema).default({})
+});
+var TraceContextSchema = z.object({
+  traceId: z.string(),
+  spanId: z.string(),
+  parentId: z.string().optional()
+});
+var WorkspaceInfoSchema = z.object({
+  workspaceId: z.string(),
+  repoFingerprint: z.string().optional(),
+  branch: z.string().optional()
+});
+var PluginInfoSchema = z.object({
+  id: z.string(),
+  version: z.string()
+});
+var HelloMessageSchema = z.object({
+  type: z.literal("hello"),
+  protocolVersion: z.string(),
+  agentVersion: z.string(),
+  hostId: z.string().optional(),
+  // для reconnect
+  capabilities: z.array(z.string()).optional(),
+  // адаптеры которые умеет этот хост
+  hostType: z.enum(["local", "cloud"]).optional(),
+  // Workspace Agent type
+  workspaces: z.array(WorkspaceInfoSchema).optional(),
+  // advertised workspaces
+  plugins: z.array(PluginInfoSchema).optional()
+  // installed plugins inventory
+});
+var ConnectedMessageSchema = z.object({
+  type: z.literal("connected"),
+  protocolVersion: z.string(),
+  hostId: z.string(),
+  sessionId: z.string()
+});
+var NegotiateMessageSchema = z.object({
+  type: z.literal("negotiate"),
+  supportedVersions: z.array(z.string())
+});
+var CallMessageSchema = z.object({
+  type: z.literal("call"),
+  requestId: z.string(),
+  adapter: z.string(),
+  method: z.string(),
+  args: z.array(z.unknown()),
+  bulk: z.boolean().optional(),
+  // true → BulkRedirect
+  trace: TraceContextSchema
+});
+var BulkRedirectMessageSchema = z.object({
+  type: z.literal("bulk-redirect"),
+  requestId: z.string(),
+  uploadUrl: z.string(),
+  expiresAt: z.number()
+});
+var ChunkMessageSchema = z.object({
+  type: z.literal("chunk"),
+  requestId: z.string(),
+  data: z.unknown(),
+  index: z.number()
+});
+var ResultMessageSchema = z.object({
+  type: z.literal("result"),
+  requestId: z.string(),
+  done: z.literal(true),
+  trace: TraceContextSchema.optional()
+});
+var ErrorMessageSchema = z.object({
+  type: z.literal("error"),
+  requestId: z.string(),
+  error: z.object({
+    code: z.string(),
+    message: z.string(),
+    retryable: z.boolean()
+  })
+});
+var HeartbeatMessageSchema = z.object({
+  type: z.literal("heartbeat")
+});
+var AckMessageSchema = z.object({
+  type: z.literal("ack")
+});
+var ExecutionOutputSchema = z.object({
+  type: z.literal("execution:output"),
+  requestId: z.string(),
+  executionId: z.string(),
+  stream: z.enum(["stdout", "stderr"]),
+  data: z.string(),
+  timestamp: z.number()
+});
+var ExecutionProgressSchema = z.object({
+  type: z.literal("execution:progress"),
+  requestId: z.string(),
+  executionId: z.string(),
+  step: z.number().int().nonnegative(),
+  total: z.number().int().positive(),
+  label: z.string(),
+  timestamp: z.number()
+});
+var ExecutionArtifactSchema = z.object({
+  type: z.literal("execution:artifact"),
+  requestId: z.string(),
+  executionId: z.string(),
+  name: z.string(),
+  mime: z.string(),
+  url: z.string(),
+  sizeBytes: z.number().optional()
+});
+var ExecutionErrorEventSchema = z.object({
+  type: z.literal("execution:error"),
+  requestId: z.string(),
+  executionId: z.string(),
+  code: z.string(),
+  message: z.string(),
+  retryable: z.boolean(),
+  attempt: z.number().int().optional(),
+  maxAttempts: z.number().int().optional()
+});
+var ExecutionDoneSchema = z.object({
+  type: z.literal("execution:done"),
+  requestId: z.string(),
+  executionId: z.string(),
+  exitCode: z.number().int(),
+  durationMs: z.number().int().nonnegative(),
+  metadata: z.record(z.string(), z.unknown()).optional()
+});
+var ExecutionRetrySchema = z.object({
+  type: z.literal("execution:retry"),
+  requestId: z.string(),
+  executionId: z.string(),
+  attempt: z.number().int().positive(),
+  maxAttempts: z.number().int().positive(),
+  delayMs: z.number().nonnegative(),
+  error: z.string()
+});
+var ExecutionCancelledSchema = z.object({
+  type: z.literal("execution:cancelled"),
+  requestId: z.string(),
+  executionId: z.string(),
+  reason: z.enum(["user", "timeout", "disconnect", "system"]),
+  durationMs: z.number().int().nonnegative()
+});
+var CancelMessageSchema = z.object({
+  type: z.literal("cancel"),
+  requestId: z.string(),
+  reason: z.enum(["user", "timeout", "disconnect"]).optional()
+});
+var SubscribeMessageSchema = z.object({
+  type: z.literal("subscribe"),
+  executionId: z.string()
+});
+var UnsubscribeMessageSchema = z.object({
+  type: z.literal("unsubscribe"),
+  executionId: z.string()
+});
+var SerializedErrorSchema = z.object({
+  code: z.string(),
+  message: z.string(),
+  retryable: z.boolean(),
+  details: z.unknown().optional()
+});
+var AdapterCallContextSchema = z.object({
+  namespaceId: z.string(),
+  hostId: z.string(),
+  workspaceId: z.string().optional(),
+  environmentId: z.string().optional(),
+  executionRequestId: z.string().optional()
+});
+var AdapterNameSchema = z.enum([
+  "llm",
+  "cache",
+  "vectorStore",
+  "embeddings",
+  "storage",
+  "state"
+]);
+var AdapterCallMessageSchema = z.object({
+  type: z.literal("adapter:call"),
+  requestId: z.string(),
+  adapter: AdapterNameSchema,
+  method: z.string(),
+  args: z.array(z.unknown()),
+  timeout: z.number().positive().optional(),
+  context: AdapterCallContextSchema
+});
+var AdapterResponseMessageSchema = z.object({
+  type: z.literal("adapter:response"),
+  requestId: z.string(),
+  result: z.unknown()
+});
+var AdapterErrorMessageSchema = z.object({
+  type: z.literal("adapter:error"),
+  requestId: z.string(),
+  error: SerializedErrorSchema
+});
+var AdapterChunkMessageSchema = z.object({
+  type: z.literal("adapter:chunk"),
+  requestId: z.string(),
+  data: z.unknown(),
+  index: z.number().int().nonnegative()
+});
+var AdapterCancelMessageSchema = z.object({
+  type: z.literal("adapter:cancel"),
+  requestId: z.string()
+});
+var ExecuteRequestSchema = z.object({
+  pluginId: z.string(),
+  handlerRef: z.string(),
+  exportName: z.string().optional(),
+  input: z.unknown(),
+  timeoutMs: z.number().int().positive().optional()
+});
+var SUPPORTED_PROTOCOL_VERSIONS = ["1.0"];
+
+// src/host.ts
+var HostCapabilitySchema = z.enum(["filesystem", "git", "editor-context", "execution"]);
+var HostTypeSchema = z.enum(["local", "cloud"]);
+var HostRegistrationSchema = z.object({
+  name: z.string(),
+  namespaceId: z.string(),
+  capabilities: z.array(HostCapabilitySchema),
+  workspacePaths: z.array(z.string()),
+  hostType: HostTypeSchema.optional()
+});
+var HostStatusSchema = z.enum(["online", "offline", "degraded", "reconnecting"]);
+var HostDescriptorSchema = z.object({
+  hostId: z.string(),
+  name: z.string(),
+  namespaceId: z.string(),
+  capabilities: z.array(HostCapabilitySchema),
+  status: HostStatusSchema,
+  lastSeen: z.number(),
+  connections: z.array(z.string()),
+  // Workspace Agent metadata (populated from hello message)
+  hostType: HostTypeSchema.optional(),
+  workspaces: z.array(WorkspaceInfoSchema).optional(),
+  plugins: z.array(PluginInfoSchema).optional(),
+  // Persistence metadata
+  createdAt: z.number().optional(),
+  updatedAt: z.number().optional()
+});
+var HostRegisterResponseSchema = z.object({
+  hostId: z.string(),
+  machineToken: z.string(),
+  status: HostStatusSchema
+});
+var TokenTypeSchema = z.enum(["user", "cli", "machine"]);
+var AuthContextSchema = z.object({
+  type: TokenTypeSchema,
+  userId: z.string(),
+  namespaceId: z.string(),
+  tier: z.enum(["free", "pro", "enterprise"]),
+  permissions: z.array(z.string())
+});
+var RegisterRequestSchema = z.object({
+  /** Human-readable name for this agent (e.g. "MacBook Pro") */
+  name: z.string().min(1).max(64),
+  namespaceId: z.string().min(1).max(64),
+  capabilities: z.array(z.string()).default([]),
+  /**
+   * X25519 public key for E2E encryption, base64url encoded.
+   * Generated by the agent; the server stores it for encrypting call payloads.
+   */
+  publicKey: z.string().optional()
+});
+var RegisterResponseSchema = z.object({
+  clientId: z.string(),
+  clientSecret: z.string(),
+  hostId: z.string()
+});
+var TokenRequestSchema = z.object({
+  clientId: z.string(),
+  clientSecret: z.string()
+});
+var TokenResponseSchema = z.object({
+  accessToken: z.string(),
+  refreshToken: z.string(),
+  /** Seconds until accessToken expires */
+  expiresIn: z.number(),
+  tokenType: z.literal("Bearer")
+});
+var RefreshRequestSchema = z.object({
+  refreshToken: z.string()
+});
+var JwtPayloadSchema = z.object({
+  sub: z.string(),
+  // hostId
+  namespaceId: z.string(),
+  tier: z.enum(["free", "pro", "enterprise"]),
+  type: TokenTypeSchema,
+  iat: z.number(),
+  exp: z.number()
+});
+var ClientHelloSchema = z.object({
+  type: z.literal("client:hello"),
+  clientVersion: z.string()
+});
+var ClientSubscribeSchema = z.object({
+  type: z.literal("client:subscribe"),
+  executionId: z.string().uuid()
+});
+var ClientUnsubscribeSchema = z.object({
+  type: z.literal("client:unsubscribe"),
+  executionId: z.string().uuid()
+});
+var ClientCancelSchema = z.object({
+  type: z.literal("client:cancel"),
+  executionId: z.string().uuid(),
+  reason: z.enum(["user", "timeout"]).optional()
+});
+var ClientConnectedSchema = z.object({
+  type: z.literal("client:connected"),
+  protocolVersion: z.string(),
+  connectionId: z.string()
+});
+var ClientErrorSchema = z.object({
+  type: z.literal("client:error"),
+  code: z.enum([
+    "EXECUTION_NOT_FOUND",
+    "FORBIDDEN",
+    "INVALID_MESSAGE",
+    "CANCEL_FAILED"
+  ]),
+  message: z.string(),
+  executionId: z.string().optional()
+});
+var CLIENT_PROTOCOL_VERSION = "1.0";
+var LLMTierSchema = z.enum(["small", "medium", "large"]);
+var ChatMessageSchema = z.object({
+  role: z.enum(["system", "user", "assistant", "tool"]),
+  content: z.string(),
+  tool_call_id: z.string().optional(),
+  tool_calls: z.array(
+    z.object({
+      id: z.string(),
+      type: z.literal("function"),
+      function: z.object({
+        name: z.string(),
+        arguments: z.string()
+        // JSON-stringified
+      })
+    })
+  ).optional()
+});
+var ChatToolSchema = z.object({
+  type: z.literal("function"),
+  function: z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    parameters: z.record(z.unknown()).optional()
+  })
+});
+var ChatCompletionRequestSchema = z.object({
+  /** Tier-based model selector: "small" | "medium" | "large" | "fast" */
+  model: LLMTierSchema,
+  messages: z.array(ChatMessageSchema).min(1),
+  temperature: z.number().min(0).max(2).optional(),
+  max_tokens: z.number().int().positive().optional(),
+  stop: z.union([z.string(), z.array(z.string())]).optional(),
+  stream: z.boolean().optional().default(false),
+  tools: z.array(ChatToolSchema).optional(),
+  tool_choice: z.union([
+    z.enum(["auto", "required", "none"]),
+    z.object({
+      type: z.literal("function"),
+      function: z.object({ name: z.string() })
+    })
+  ]).optional()
+});
+var TelemetryEventSchema = z.object({
+  /** Source product/service name (e.g., "my-api", "billing-service") */
+  source: z.string().min(1).max(128),
+  /** Event type/name using dot notation (e.g., "user.signup", "api.request") */
+  type: z.string().min(1).max(256),
+  /** ISO 8601 timestamp. Defaults to server ingest time if omitted. */
+  timestamp: z.string().datetime().optional(),
+  /** Free-form event data. No schema enforced — products decide what to send. */
+  payload: z.record(z.unknown()).optional(),
+  /** Flat key-value tags for filtering/aggregation (e.g., { env: "prod", region: "eu" }) */
+  tags: z.record(z.string()).optional()
+});
+var TelemetryIngestRequestSchema = z.object({
+  /** Array of events to ingest (1–500 per batch) */
+  events: z.array(TelemetryEventSchema).min(1).max(500)
+});
+var PlatformCallRequestSchema = z.object({
+  /** Arguments to pass to the adapter method. Order matters. */
+  args: z.array(z.unknown()).default([])
+});
+
+export { AckMessageSchema, AdapterCallContextSchema, AdapterCallMessageSchema, AdapterCancelMessageSchema, AdapterChunkMessageSchema, AdapterErrorMessageSchema, AdapterNameSchema, AdapterResponseMessageSchema, AuthContextSchema, BulkRedirectMessageSchema, CLIENT_PROTOCOL_VERSION, CallMessageSchema, CancelMessageSchema, ChatCompletionRequestSchema, ChatMessageSchema, ChatToolSchema, ChunkMessageSchema, ClientCancelSchema, ClientConnectedSchema, ClientErrorSchema, ClientHelloSchema, ClientSubscribeSchema, ClientUnsubscribeSchema, ConnectedMessageSchema, ErrorMessageSchema, ExecuteRequestSchema, ExecutionArtifactSchema, ExecutionCancelledSchema, ExecutionDoneSchema, ExecutionErrorEventSchema, ExecutionOutputSchema, ExecutionProgressSchema, ExecutionRetrySchema, GatewayConfigSchema, HeartbeatMessageSchema, HelloMessageSchema, HostCapabilitySchema, HostDescriptorSchema, HostRegisterResponseSchema, HostRegistrationSchema, HostStatusSchema, HostTypeSchema, JwtPayloadSchema, LLMTierSchema, NegotiateMessageSchema, PlatformCallRequestSchema, PluginInfoSchema, RefreshRequestSchema, RegisterRequestSchema, RegisterResponseSchema, ResultMessageSchema, SUPPORTED_PROTOCOL_VERSIONS, SerializedErrorSchema, StaticTokenEntrySchema, SubscribeMessageSchema, TelemetryEventSchema, TelemetryIngestRequestSchema, TokenRequestSchema, TokenResponseSchema, TokenTypeSchema, TraceContextSchema, UnsubscribeMessageSchema, UpstreamConfigSchema, WorkspaceInfoSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/protocol.ts","../src/host.ts","../src/auth.ts","../src/client-protocol.ts","../src/llm-gateway.ts","../src/telemetry.ts","../src/platform-api.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\nexport const UpstreamConfigSchema = z.object({\n  url: z.string().url(),\n  prefix: z.string().startsWith('/'),\n  /** Strip prefix before forwarding. Default: keep prefix as-is. Use \"\" to strip. */\n  rewritePrefix: z.string().optional(),\n  /** Enable WebSocket proxying for this upstream. Default: false. */\n  websocket: z.boolean().optional(),\n  /** Paths under this prefix that are NOT proxied (handled by gateway itself). */\n  excludePaths: z.array(z.string()).optional(),\n  description: z.string().optional(),\n});\n\nexport const StaticTokenEntrySchema = z.object({\n  hostId: z.string(),\n  namespaceId: z.string(),\n});\n\nexport const GatewayConfigSchema = z.object({\n  port: z.number().default(4000),\n  upstreams: z.record(z.string(), UpstreamConfigSchema).default({}),\n  /** Static tokens seeded into ICache at bootstrap — for dev/service tokens before full auth */\n  staticTokens: z.record(z.string(), StaticTokenEntrySchema).default({}),\n});\n\nexport type UpstreamConfig = z.infer<typeof UpstreamConfigSchema>;\nexport type GatewayConfig = z.infer<typeof GatewayConfigSchema>;\n","import { z } from 'zod';\n\nexport const TraceContextSchema = z.object({\n  traceId: z.string(),\n  spanId: z.string(),\n  parentId: z.string().optional(),\n});\n\n// Workspace info advertised by host on connect\nexport const WorkspaceInfoSchema = z.object({\n  workspaceId: z.string(),\n  repoFingerprint: z.string().optional(),\n  branch: z.string().optional(),\n});\n\n// Plugin inventory advertised by host on connect\nexport const PluginInfoSchema = z.object({\n  id: z.string(),\n  version: z.string(),\n});\n\n// Host → Gateway: первое сообщение после подключения\nexport const HelloMessageSchema = z.object({\n  type: z.literal('hello'),\n  protocolVersion: z.string(),\n  agentVersion: z.string(),\n  hostId: z.string().optional(), // для reconnect\n  capabilities: z.array(z.string()).optional(), // адаптеры которые умеет этот хост\n  hostType: z.enum(['local', 'cloud']).optional(), // Workspace Agent type\n  workspaces: z.array(WorkspaceInfoSchema).optional(), // advertised workspaces\n  plugins: z.array(PluginInfoSchema).optional(), // installed plugins inventory\n});\n\n// Gateway → Host: подтверждение подключения\nexport const ConnectedMessageSchema = z.object({\n  type: z.literal('connected'),\n  protocolVersion: z.string(),\n  hostId: z.string(),\n  sessionId: z.string(),\n});\n\n// Gateway → Host: версия несовместима\nexport const NegotiateMessageSchema = z.object({\n  type: z.literal('negotiate'),\n  supportedVersions: z.array(z.string()),\n});\n\n// Gateway → Host: вызов адаптера\nexport const CallMessageSchema = z.object({\n  type: z.literal('call'),\n  requestId: z.string(),\n  adapter: z.string(),\n  method: z.string(),\n  args: z.array(z.unknown()),\n  bulk: z.boolean().optional(), // true → BulkRedirect\n  trace: TraceContextSchema,\n});\n\n// Gateway → Host: redirect для bulk операций (большие файлы)\nexport const BulkRedirectMessageSchema = z.object({\n  type: z.literal('bulk-redirect'),\n  requestId: z.string(),\n  uploadUrl: z.string(),\n  expiresAt: z.number(),\n});\n\n// Host → Gateway: чанк данных (стриминг)\nexport const ChunkMessageSchema = z.object({\n  type: z.literal('chunk'),\n  requestId: z.string(),\n  data: z.unknown(),\n  index: z.number(),\n});\n\n// Host → Gateway: завершение вызова\nexport const ResultMessageSchema = z.object({\n  type: z.literal('result'),\n  requestId: z.string(),\n  done: z.literal(true),\n  trace: TraceContextSchema.optional(),\n});\n\n// Host → Gateway: ошибка при вызове\nexport const ErrorMessageSchema = z.object({\n  type: z.literal('error'),\n  requestId: z.string(),\n  error: z.object({\n    code: z.string(),\n    message: z.string(),\n    retryable: z.boolean(),\n  }),\n});\n\n// Host → Gateway: heartbeat\nexport const HeartbeatMessageSchema = z.object({\n  type: z.literal('heartbeat'),\n});\n\n// Gateway → Host: ack heartbeat\nexport const AckMessageSchema = z.object({\n  type: z.literal('ack'),\n});\n\n// ── Execution event schemas (CC1 — Streaming) ──\n\n// Execution output event (stdout/stderr from handler)\nexport const ExecutionOutputSchema = z.object({\n  type: z.literal('execution:output'),\n  requestId: z.string(),\n  executionId: z.string(),\n  stream: z.enum(['stdout', 'stderr']),\n  data: z.string(),\n  timestamp: z.number(),\n});\n\n// Execution progress event\nexport const ExecutionProgressSchema = z.object({\n  type: z.literal('execution:progress'),\n  requestId: z.string(),\n  executionId: z.string(),\n  step: z.number().int().nonnegative(),\n  total: z.number().int().positive(),\n  label: z.string(),\n  timestamp: z.number(),\n});\n\n// Execution artifact event (file created during execution)\nexport const ExecutionArtifactSchema = z.object({\n  type: z.literal('execution:artifact'),\n  requestId: z.string(),\n  executionId: z.string(),\n  name: z.string(),\n  mime: z.string(),\n  url: z.string(),\n  sizeBytes: z.number().optional(),\n});\n\n// Execution error event\nexport const ExecutionErrorEventSchema = z.object({\n  type: z.literal('execution:error'),\n  requestId: z.string(),\n  executionId: z.string(),\n  code: z.string(),\n  message: z.string(),\n  retryable: z.boolean(),\n  attempt: z.number().int().optional(),\n  maxAttempts: z.number().int().optional(),\n});\n\n// Execution done event (final — execution completed)\nexport const ExecutionDoneSchema = z.object({\n  type: z.literal('execution:done'),\n  requestId: z.string(),\n  executionId: z.string(),\n  exitCode: z.number().int(),\n  durationMs: z.number().int().nonnegative(),\n  metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\n// Execution retry event (between attempts — CC3)\nexport const ExecutionRetrySchema = z.object({\n  type: z.literal('execution:retry'),\n  requestId: z.string(),\n  executionId: z.string(),\n  attempt: z.number().int().positive(),\n  maxAttempts: z.number().int().positive(),\n  delayMs: z.number().nonnegative(),\n  error: z.string(),\n});\n\n// Execution cancelled event\nexport const ExecutionCancelledSchema = z.object({\n  type: z.literal('execution:cancelled'),\n  requestId: z.string(),\n  executionId: z.string(),\n  reason: z.enum(['user', 'timeout', 'disconnect', 'system']),\n  durationMs: z.number().int().nonnegative(),\n});\n\n// Cancel message: client → Gateway\nexport const CancelMessageSchema = z.object({\n  type: z.literal('cancel'),\n  requestId: z.string(),\n  reason: z.enum(['user', 'timeout', 'disconnect']).optional(),\n});\n\n// Subscribe message: client → Gateway (multi-client pub/sub, CC5)\nexport const SubscribeMessageSchema = z.object({\n  type: z.literal('subscribe'),\n  executionId: z.string(),\n});\n\n// Unsubscribe message: client → Gateway\nexport const UnsubscribeMessageSchema = z.object({\n  type: z.literal('unsubscribe'),\n  executionId: z.string(),\n});\n\n// ── Adapter reverse proxy schemas (Workspace Agent → Gateway → Platform) ──\n\n/** Serialized error for adapter:error messages */\nexport const SerializedErrorSchema = z.object({\n  code: z.string(),\n  message: z.string(),\n  retryable: z.boolean(),\n  details: z.unknown().optional(),\n});\n\n/** Adapter call context — propagated from host to platform */\nexport const AdapterCallContextSchema = z.object({\n  namespaceId: z.string(),\n  hostId: z.string(),\n  workspaceId: z.string().optional(),\n  environmentId: z.string().optional(),\n  executionRequestId: z.string().optional(),\n});\n\n/** Allowed adapter names for reverse proxy */\nexport const AdapterNameSchema = z.enum([\n  'llm',\n  'cache',\n  'vectorStore',\n  'embeddings',\n  'storage',\n  'state',\n]);\n\n// Host → Gateway: вызов platform adapter (reverse proxy)\nexport const AdapterCallMessageSchema = z.object({\n  type: z.literal('adapter:call'),\n  requestId: z.string(),\n  adapter: AdapterNameSchema,\n  method: z.string(),\n  args: z.array(z.unknown()),\n  timeout: z.number().positive().optional(),\n  context: AdapterCallContextSchema,\n});\n\n// Gateway → Host: успешный ответ на adapter:call\nexport const AdapterResponseMessageSchema = z.object({\n  type: z.literal('adapter:response'),\n  requestId: z.string(),\n  result: z.unknown(),\n});\n\n// Gateway → Host: ошибка при adapter:call\nexport const AdapterErrorMessageSchema = z.object({\n  type: z.literal('adapter:error'),\n  requestId: z.string(),\n  error: SerializedErrorSchema,\n});\n\n// Gateway → Host: streaming chunk для adapter:call (Phase 2+)\nexport const AdapterChunkMessageSchema = z.object({\n  type: z.literal('adapter:chunk'),\n  requestId: z.string(),\n  data: z.unknown(),\n  index: z.number().int().nonnegative(),\n});\n\n// Host → Gateway: cancel in-flight adapter:call (Phase 2+)\nexport const AdapterCancelMessageSchema = z.object({\n  type: z.literal('adapter:cancel'),\n  requestId: z.string(),\n});\n\n// ── Execute request schema (for POST /api/v1/execute) ──\n\nexport const ExecuteRequestSchema = z.object({\n  pluginId: z.string(),\n  handlerRef: z.string(),\n  exportName: z.string().optional(),\n  input: z.unknown(),\n  timeoutMs: z.number().int().positive().optional(),\n});\n\nexport const SUPPORTED_PROTOCOL_VERSIONS = ['1.0'] as const;\n\nexport type TraceContext = z.infer<typeof TraceContextSchema>;\nexport type HelloMessage = z.infer<typeof HelloMessageSchema>;\nexport type ConnectedMessage = z.infer<typeof ConnectedMessageSchema>;\nexport type NegotiateMessage = z.infer<typeof NegotiateMessageSchema>;\nexport type CallMessage = z.infer<typeof CallMessageSchema>;\nexport type BulkRedirectMessage = z.infer<typeof BulkRedirectMessageSchema>;\nexport type ChunkMessage = z.infer<typeof ChunkMessageSchema>;\nexport type ResultMessage = z.infer<typeof ResultMessageSchema>;\nexport type ErrorMessage = z.infer<typeof ErrorMessageSchema>;\nexport type HeartbeatMessage = z.infer<typeof HeartbeatMessageSchema>;\nexport type AckMessage = z.infer<typeof AckMessageSchema>;\nexport type ExecutionOutputMessage = z.infer<typeof ExecutionOutputSchema>;\nexport type ExecutionProgressMessage = z.infer<typeof ExecutionProgressSchema>;\nexport type ExecutionArtifactMessage = z.infer<typeof ExecutionArtifactSchema>;\nexport type ExecutionErrorEventMessage = z.infer<typeof ExecutionErrorEventSchema>;\nexport type ExecutionDoneMessage = z.infer<typeof ExecutionDoneSchema>;\nexport type ExecutionRetryMessage = z.infer<typeof ExecutionRetrySchema>;\nexport type ExecutionCancelledMessage = z.infer<typeof ExecutionCancelledSchema>;\nexport type CancelMessage = z.infer<typeof CancelMessageSchema>;\nexport type SubscribeMessage = z.infer<typeof SubscribeMessageSchema>;\nexport type UnsubscribeMessage = z.infer<typeof UnsubscribeMessageSchema>;\nexport type ExecuteRequest = z.infer<typeof ExecuteRequestSchema>;\nexport type WorkspaceInfo = z.infer<typeof WorkspaceInfoSchema>;\nexport type PluginInfo = z.infer<typeof PluginInfoSchema>;\nexport type SerializedError = z.infer<typeof SerializedErrorSchema>;\nexport type AdapterCallContext = z.infer<typeof AdapterCallContextSchema>;\nexport type AdapterName = z.infer<typeof AdapterNameSchema>;\nexport type AdapterCallMessage = z.infer<typeof AdapterCallMessageSchema>;\nexport type AdapterResponseMessage = z.infer<typeof AdapterResponseMessageSchema>;\nexport type AdapterErrorMessage = z.infer<typeof AdapterErrorMessageSchema>;\nexport type AdapterChunkMessage = z.infer<typeof AdapterChunkMessageSchema>;\nexport type AdapterCancelMessage = z.infer<typeof AdapterCancelMessageSchema>;\n\nexport type ExecutionEventMessage =\n  | ExecutionOutputMessage\n  | ExecutionProgressMessage\n  | ExecutionArtifactMessage\n  | ExecutionErrorEventMessage\n  | ExecutionDoneMessage\n  | ExecutionRetryMessage\n  | ExecutionCancelledMessage;\n\nexport type InboundMessage =\n  | HelloMessage\n  | HeartbeatMessage\n  | ChunkMessage\n  | ResultMessage\n  | ErrorMessage\n  | CancelMessage\n  | SubscribeMessage\n  | UnsubscribeMessage\n  | AdapterCallMessage\n  | AdapterCancelMessage;\n\nexport type OutboundMessage =\n  | ConnectedMessage\n  | NegotiateMessage\n  | CallMessage\n  | BulkRedirectMessage\n  | AckMessage\n  | ExecutionOutputMessage\n  | ExecutionProgressMessage\n  | ExecutionArtifactMessage\n  | ExecutionErrorEventMessage\n  | ExecutionDoneMessage\n  | AdapterResponseMessage\n  | AdapterErrorMessage\n  | AdapterChunkMessage;\n","import { z } from 'zod';\nimport { WorkspaceInfoSchema, PluginInfoSchema } from './protocol.js';\n\nexport const HostCapabilitySchema = z.enum(['filesystem', 'git', 'editor-context', 'execution']);\n\nexport const HostTypeSchema = z.enum(['local', 'cloud']);\n\nexport const HostRegistrationSchema = z.object({\n  name: z.string(),\n  namespaceId: z.string(),\n  capabilities: z.array(HostCapabilitySchema),\n  workspacePaths: z.array(z.string()),\n  hostType: HostTypeSchema.optional(),\n});\n\nexport const HostStatusSchema = z.enum(['online', 'offline', 'degraded', 'reconnecting']);\n\nexport const HostDescriptorSchema = z.object({\n  hostId: z.string(),\n  name: z.string(),\n  namespaceId: z.string(),\n  capabilities: z.array(HostCapabilitySchema),\n  status: HostStatusSchema,\n  lastSeen: z.number(),\n  connections: z.array(z.string()),\n  // Workspace Agent metadata (populated from hello message)\n  hostType: HostTypeSchema.optional(),\n  workspaces: z.array(WorkspaceInfoSchema).optional(),\n  plugins: z.array(PluginInfoSchema).optional(),\n  // Persistence metadata\n  createdAt: z.number().optional(),\n  updatedAt: z.number().optional(),\n});\n\nexport const HostRegisterResponseSchema = z.object({\n  hostId: z.string(),\n  machineToken: z.string(),\n  status: HostStatusSchema,\n});\n\nexport type HostStatus = z.infer<typeof HostStatusSchema>;\nexport type HostCapability = z.infer<typeof HostCapabilitySchema>;\nexport type HostType = z.infer<typeof HostTypeSchema>;\nexport type HostRegistration = z.infer<typeof HostRegistrationSchema>;\nexport type HostDescriptor = z.infer<typeof HostDescriptorSchema>;\nexport type HostRegisterResponse = z.infer<typeof HostRegisterResponseSchema>;\n\n/**\n * Durable host storage abstraction.\n *\n * Implementations persist host descriptors and tokens across restarts.\n * The registry uses this as the \"cold\" layer while ICache serves as \"hot\" layer.\n */\nexport interface IHostStore {\n  /** Persist or update a host descriptor. */\n  save(descriptor: HostDescriptor): Promise<void>;\n\n  /** Retrieve a host by id + namespace. */\n  get(hostId: string, namespaceId: string): Promise<HostDescriptor | null>;\n\n  /** List all hosts in a namespace. */\n  list(namespaceId: string): Promise<HostDescriptor[]>;\n\n  /** List all hosts across all namespaces. */\n  listAll(): Promise<HostDescriptor[]>;\n\n  /** Remove a host. Returns true if it existed. */\n  delete(hostId: string, namespaceId: string): Promise<boolean>;\n\n  /** Persist a machine token → host mapping. */\n  saveToken(token: string, hostId: string, namespaceId: string): Promise<void>;\n\n  /** Resolve a machine token to its host. */\n  resolveToken(token: string): Promise<{ hostId: string; namespaceId: string } | null>;\n\n  /** Remove a machine token. */\n  deleteToken(token: string): Promise<void>;\n}\n","import { z } from 'zod';\n\nexport const TokenTypeSchema = z.enum(['user', 'cli', 'machine']);\n\nexport const AuthContextSchema = z.object({\n  type: TokenTypeSchema,\n  userId: z.string(),\n  namespaceId: z.string(),\n  tier: z.enum(['free', 'pro', 'enterprise']),\n  permissions: z.array(z.string()),\n});\n\nexport type TokenType = z.infer<typeof TokenTypeSchema>;\nexport type AuthContext = z.infer<typeof AuthContextSchema>;\n\n// ── JWT / Auth service contracts ─────────────────────────────────────────────\n\nexport const RegisterRequestSchema = z.object({\n  /** Human-readable name for this agent (e.g. \"MacBook Pro\") */\n  name: z.string().min(1).max(64),\n  namespaceId: z.string().min(1).max(64),\n  capabilities: z.array(z.string()).default([]),\n  /**\n   * X25519 public key for E2E encryption, base64url encoded.\n   * Generated by the agent; the server stores it for encrypting call payloads.\n   */\n  publicKey: z.string().optional(),\n});\n\nexport const RegisterResponseSchema = z.object({\n  clientId: z.string(),\n  clientSecret: z.string(),\n  hostId: z.string(),\n});\n\nexport const TokenRequestSchema = z.object({\n  clientId: z.string(),\n  clientSecret: z.string(),\n});\n\nexport const TokenResponseSchema = z.object({\n  accessToken: z.string(),\n  refreshToken: z.string(),\n  /** Seconds until accessToken expires */\n  expiresIn: z.number(),\n  tokenType: z.literal('Bearer'),\n});\n\nexport const RefreshRequestSchema = z.object({\n  refreshToken: z.string(),\n});\n\n/** JWT payload (sub = hostId) */\nexport const JwtPayloadSchema = z.object({\n  sub: z.string(),       // hostId\n  namespaceId: z.string(),\n  tier: z.enum(['free', 'pro', 'enterprise']),\n  type: TokenTypeSchema,\n  iat: z.number(),\n  exp: z.number(),\n});\n\nexport type RegisterRequest = z.infer<typeof RegisterRequestSchema>;\nexport type RegisterResponse = z.infer<typeof RegisterResponseSchema>;\nexport type TokenRequest = z.infer<typeof TokenRequestSchema>;\nexport type TokenResponse = z.infer<typeof TokenResponseSchema>;\nexport type RefreshRequest = z.infer<typeof RefreshRequestSchema>;\nexport type JwtPayload = z.infer<typeof JwtPayloadSchema>;\n","/**\n * @module gateway-contracts/client-protocol\n *\n * WS protocol for observer clients (CLI, Studio, IDE).\n * Endpoint: /clients/connect\n *\n * Separate from host-protocol (protocol.ts) — clients observe executions,\n * they don't serve adapter calls.\n *\n * Client → Gateway inbound messages:\n *   - client:hello     — handshake\n *   - client:subscribe — subscribe to execution events\n *   - client:unsubscribe\n *   - client:cancel    — cancel an execution (convenience, same as POST /execute/:id/cancel)\n *\n * Gateway → Client outbound messages:\n *   - client:connected   — handshake ack\n *   - execution:output   — (reused from protocol.ts ExecutionEventMessage)\n *   - execution:progress\n *   - execution:artifact\n *   - execution:error\n *   - execution:done\n *   - client:error       — protocol-level error (bad subscribe, not found, etc.)\n */\n\nimport { z } from 'zod';\nimport type { ExecutionEventMessage } from './protocol.js';\n\n// ── Inbound (Client → Gateway) ────────────────────────────────────────────────\n\nexport const ClientHelloSchema = z.object({\n  type: z.literal('client:hello'),\n  clientVersion: z.string(),\n});\n\nexport const ClientSubscribeSchema = z.object({\n  type: z.literal('client:subscribe'),\n  executionId: z.string().uuid(),\n});\n\nexport const ClientUnsubscribeSchema = z.object({\n  type: z.literal('client:unsubscribe'),\n  executionId: z.string().uuid(),\n});\n\nexport const ClientCancelSchema = z.object({\n  type: z.literal('client:cancel'),\n  executionId: z.string().uuid(),\n  reason: z.enum(['user', 'timeout']).optional(),\n});\n\n// ── Outbound (Gateway → Client) ───────────────────────────────────────────────\n\nexport const ClientConnectedSchema = z.object({\n  type: z.literal('client:connected'),\n  protocolVersion: z.string(),\n  connectionId: z.string(),\n});\n\nexport const ClientErrorSchema = z.object({\n  type: z.literal('client:error'),\n  code: z.enum([\n    'EXECUTION_NOT_FOUND',\n    'FORBIDDEN',\n    'INVALID_MESSAGE',\n    'CANCEL_FAILED',\n  ]),\n  message: z.string(),\n  executionId: z.string().optional(),\n});\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type ClientHello = z.infer<typeof ClientHelloSchema>;\nexport type ClientSubscribe = z.infer<typeof ClientSubscribeSchema>;\nexport type ClientUnsubscribe = z.infer<typeof ClientUnsubscribeSchema>;\nexport type ClientCancel = z.infer<typeof ClientCancelSchema>;\nexport type ClientConnected = z.infer<typeof ClientConnectedSchema>;\nexport type ClientError = z.infer<typeof ClientErrorSchema>;\n\nexport type ClientInboundMessage =\n  | ClientHello\n  | ClientSubscribe\n  | ClientUnsubscribe\n  | ClientCancel;\n\nexport type ClientOutboundMessage =\n  | ClientConnected\n  | ClientError\n  | ExecutionEventMessage;\n\nexport const CLIENT_PROTOCOL_VERSION = '1.0';\n","/**\n * @module @kb-labs/gateway-contracts/llm-gateway\n * OpenAI-compatible AI Gateway schemas and types.\n *\n * Clients interact using OpenAI ChatCompletion format, but `model` field\n * is a tier abstraction (small/medium/large/fast), NOT a literal model name.\n * The platform resolves the tier to a concrete provider + model via LLMRouter config.\n */\nimport { z } from 'zod';\n\n// ── Request ─────────────────────────────────────────────────────────────────\n\n/** Tier-based model selector. Clients never specify a concrete model. */\nexport const LLMTierSchema = z.enum(['small', 'medium', 'large']);\n\nexport const ChatMessageSchema = z.object({\n  role: z.enum(['system', 'user', 'assistant', 'tool']),\n  content: z.string(),\n  tool_call_id: z.string().optional(),\n  tool_calls: z\n    .array(\n      z.object({\n        id: z.string(),\n        type: z.literal('function'),\n        function: z.object({\n          name: z.string(),\n          arguments: z.string(), // JSON-stringified\n        }),\n      }),\n    )\n    .optional(),\n});\n\nexport const ChatToolSchema = z.object({\n  type: z.literal('function'),\n  function: z.object({\n    name: z.string(),\n    description: z.string().optional(),\n    parameters: z.record(z.unknown()).optional(),\n  }),\n});\n\nexport const ChatCompletionRequestSchema = z.object({\n  /** Tier-based model selector: \"small\" | \"medium\" | \"large\" | \"fast\" */\n  model: LLMTierSchema,\n  messages: z.array(ChatMessageSchema).min(1),\n  temperature: z.number().min(0).max(2).optional(),\n  max_tokens: z.number().int().positive().optional(),\n  stop: z.union([z.string(), z.array(z.string())]).optional(),\n  stream: z.boolean().optional().default(false),\n  tools: z.array(ChatToolSchema).optional(),\n  tool_choice: z\n    .union([\n      z.enum(['auto', 'required', 'none']),\n      z.object({\n        type: z.literal('function'),\n        function: z.object({ name: z.string() }),\n      }),\n    ])\n    .optional(),\n});\n\nexport type ChatCompletionRequest = z.infer<typeof ChatCompletionRequestSchema>;\n\n// ── Response ────────────────────────────────────────────────────────────────\n\nexport interface ChatCompletionChoice {\n  index: number;\n  message: {\n    role: 'assistant';\n    content: string | null;\n    tool_calls?: Array<{\n      id: string;\n      type: 'function';\n      function: { name: string; arguments: string };\n    }>;\n  };\n  finish_reason: 'stop' | 'tool_calls' | 'length' | null;\n}\n\nexport interface ChatCompletionUsage {\n  prompt_tokens: number;\n  completion_tokens: number;\n  total_tokens: number;\n}\n\nexport interface ChatCompletionResponse {\n  id: string;\n  object: 'chat.completion';\n  created: number;\n  /** Returns the tier used, not the concrete model (abstraction preserved) */\n  model: string;\n  choices: ChatCompletionChoice[];\n  usage: ChatCompletionUsage;\n}\n\n// ── Streaming ───────────────────────────────────────────────────────────────\n\nexport interface ChatCompletionChunkDelta {\n  role?: 'assistant';\n  content?: string | null;\n  tool_calls?: Array<{\n    index: number;\n    id?: string;\n    type?: 'function';\n    function?: { name?: string; arguments?: string };\n  }>;\n}\n\nexport interface ChatCompletionChunk {\n  id: string;\n  object: 'chat.completion.chunk';\n  created: number;\n  model: string;\n  choices: Array<{\n    index: number;\n    delta: ChatCompletionChunkDelta;\n    finish_reason: 'stop' | 'tool_calls' | 'length' | null;\n  }>;\n}\n","/**\n * @module @kb-labs/gateway-contracts/telemetry\n * Telemetry ingestion schemas for the AI Gateway.\n *\n * External products send events through `POST /telemetry/v1/ingest`.\n * Events are written to platform analytics (SQLite/DuckDB/File) via IAnalytics.track().\n *\n * Schema is intentionally minimal — `payload` is free-form.\n * Platform provides recommended presets but does not enforce them.\n */\nimport { z } from 'zod';\n\n// ── Single event ────────────────────────────────────────────────────────────\n\nexport const TelemetryEventSchema = z.object({\n  /** Source product/service name (e.g., \"my-api\", \"billing-service\") */\n  source: z.string().min(1).max(128),\n  /** Event type/name using dot notation (e.g., \"user.signup\", \"api.request\") */\n  type: z.string().min(1).max(256),\n  /** ISO 8601 timestamp. Defaults to server ingest time if omitted. */\n  timestamp: z.string().datetime().optional(),\n  /** Free-form event data. No schema enforced — products decide what to send. */\n  payload: z.record(z.unknown()).optional(),\n  /** Flat key-value tags for filtering/aggregation (e.g., { env: \"prod\", region: \"eu\" }) */\n  tags: z.record(z.string()).optional(),\n});\n\nexport type TelemetryEvent = z.infer<typeof TelemetryEventSchema>;\n\n// ── Batch ingestion request ─────────────────────────────────────────────────\n\nexport const TelemetryIngestRequestSchema = z.object({\n  /** Array of events to ingest (1–500 per batch) */\n  events: z.array(TelemetryEventSchema).min(1).max(500),\n});\n\nexport type TelemetryIngestRequest = z.infer<typeof TelemetryIngestRequestSchema>;\n\n// ── Ingestion response ──────────────────────────────────────────────────────\n\nexport interface TelemetryIngestResponse {\n  /** Number of events accepted */\n  accepted: number;\n  /** Number of events rejected (validation errors) */\n  rejected: number;\n  /** Errors for rejected events, if any */\n  errors?: Array<{ index: number; message: string }>;\n}\n","/**\n * @module @kb-labs/gateway-contracts/platform-api\n * Unified Platform API — single dispatch endpoint for any adapter.\n *\n * Route: POST /platform/v1/{adapter}/{method}\n * Adapter and method come from URL params; args come from the request body.\n */\nimport { z } from 'zod';\n\n// ── Request ─────────────────────────────────────────────────────────────────\n\nexport const PlatformCallRequestSchema = z.object({\n  /** Arguments to pass to the adapter method. Order matters. */\n  args: z.array(z.unknown()).default([]),\n});\n\nexport type PlatformCallRequest = z.infer<typeof PlatformCallRequestSchema>;\n\n// ── Response ────────────────────────────────────────────────────────────────\n\nexport interface PlatformCallResponse {\n  ok: boolean;\n  result?: unknown;\n  error?: { message: string; code?: string };\n  /** Wall-clock duration of the adapter call in milliseconds. */\n  durationMs: number;\n}\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@kb-labs/gateway-contracts",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run -c ../../vitest.config.ts",
+    "test:watch": "vitest -c ../../vitest.config.ts"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@kb-labs/devkit": "link:../../../kb-labs-devkit",
+    "tsup": "^8.5.0",
+    "vitest": "^3.2.4"
+  }
+}