@scribed/cli 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@scribed/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Command-line client + MCP server for Scribed — CRM records, phone + texting, inbox, calendar + booking, transcriptions, HR, Vault, automations, Creative Studio, and Documents, derived from the scribed-agent tool catalog.",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://scribed.ai",
+  "keywords": [
+    "scribed",
+    "mcp",
+    "cli",
+    "crm",
+    "agent"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "scribed": "bin/scribed.mjs"
+  },
+  "exports": {
+    "./mcp": {
+      "types": "./types/mcp.d.ts",
+      "bun": "./src/mcp/server.ts",
+      "default": "./dist/mcp/server.js"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "types"
+  ],
+  "scripts": {
+    "test": "bun test",
+    "type-check": "NODE_OPTIONS=--max-old-space-size=12288 tsc --noEmit",
+    "build": "bun build src/index.ts src/mcp/server.ts --target=node --outdir=dist --root=src",
+    "verify:stdio": "bun run build && bun scripts/verify-stdio.ts",
+    "verify:bundle": "bun run build && bun scripts/verify-bundle.ts",
+    "verify:files": "bun run build && bun scripts/verify-files.ts",
+    "verify:catalog": "bun scripts/verify-catalog.ts",
+    "smoke": "bun scripts/smoke-tools.ts",
+    "smoke:companions": "bun scripts/smoke-companions.ts",
+    "prepack": "bun run type-check && bun run test && bun run build && bun scripts/verify-bundle.ts && bun scripts/verify-stdio.ts && bun scripts/verify-files.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@vercel/blob": "^2.5.0",
+    "commander": "^15.0.0",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "@types/node": "^26.0.1",
+    "typescript": "^6.0.3"
+  }
+}

package/types/mcp.d.ts

@@ -0,0 +1,140 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { z } from 'zod';
+
+/**
+ * Public surface of `@scribed/cli/mcp` — the catalog adapter + MCP server
+ * factory the hosted scribed-api `/mcp` and `/v1/tools` routes build on.
+ * Hand-maintained to match `src/mcp/server.ts`.
+ */
+
+export interface PublicToolCatalogItem {
+  name: string;
+  category: string;
+  description: string;
+  access: 'Standard' | 'AI-powered' | 'Storage/processing' | 'Connected account';
+}
+
+export interface CatalogToolDefinition {
+  description: string;
+  inputSchema: z.ZodType;
+  execute: (
+    args: unknown,
+    options: { toolCallId: string; messages: never[] }
+  ) => unknown;
+  httpMethod?: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+  readOnly?: boolean;
+  binaryUpload?: BinaryUploadDescriptor;
+  /** Complete image results are rendered as native MCP image content. */
+  outputKind?: 'image';
+}
+
+export interface BinaryUploadDescriptor {
+  argumentName: string;
+  maxBytes: number;
+  inlineMaxBytes?: number;
+  allowEmpty?: boolean;
+  directUpload?: { provider: 'vercel-blob'; startTool: string; completeTool: string; cancelTool: string };
+}
+export interface ToolUpload { stream: ReadableStream<Uint8Array>; size: number; name: string; mimeType: string; maxBytes: number }
+
+export interface CatalogToolError {
+  error: true;
+  message: string;
+  code?: string;
+  status?: number | null;
+  retryAfterSeconds?: number;
+}
+
+export interface CatalogToolInvocation {
+  id: string;
+  name: string;
+  feature: string;
+  classification: 'paid' | 'usage_only' | 'overhead' | 'byok';
+  owner: 'agent' | 'app-worker' | 'downstream-worker' | 'user-provider';
+  providerCost: 'platform' | 'zero_byok' | 'none';
+  platformInfrastructure: true;
+  outcome: 'completed' | 'failed' | 'cancelled';
+  durationMs: number;
+  status?: number;
+}
+
+export interface CatalogCallContext {
+  apiUrl: string;
+  /** Better Auth bearer session token or hosted-MCP OAuth access token. */
+  token?: string;
+  /** Personal API key (`scribed_api_…`): executes through POST /v1/tools/:name. */
+  apiKey?: string;
+  /** Selected workspace: X-Workspace-Id (bearer / API key) or ?workspace= (hosted MCP). */
+  workspaceId?: string;
+  /** Browser-OAuth CLI sessions execute through the hosted MCP resource. */
+  remoteMcpUrl?: string;
+  /** Hosted Scribed API only; never accepted from CLI flags or environment. */
+  mcpSigningKey?: string;
+  uploads?: ReadonlyMap<string, ToolUpload>;
+  signal?: AbortSignal;
+  uploadApiUrl?: string;
+  billing?: {
+    consumerApp: 'scribed';
+    userId: string;
+    tenantId: string;
+    traceId: string;
+    feature: string;
+  };
+}
+
+export interface CatalogExecutionResult {
+  result: unknown;
+  toolInvocations: CatalogToolInvocation[];
+}
+
+export interface McpServerOptions {
+  apiUrl: string;
+  token?: string;
+  /** "core" (default), "all", or comma-separated category slugs. */
+  categories?: string;
+  /** Hosted Scribed API only; signs catalog-derived loopback requests. */
+  internalSigningKey?: string;
+  /** Hosted Scribed API only; omit state-changing tools. */
+  readOnly?: boolean;
+  /** Pin every tool call to one workspace. */
+  workspaceId?: string;
+  /** Local stdio only; resolves/refreshes its execution credentials per call. */
+  contextProvider?: () => Promise<CatalogCallContext>;
+}
+
+export declare const SERVER_INSTRUCTIONS: string;
+
+export declare function createMcpServer(options: McpServerOptions): McpServer;
+
+export declare function resolveCategorySelection(
+  selection?: string
+): ReadonlySet<string>;
+
+export declare function catalogItems(): PublicToolCatalogItem[];
+export declare function catalogRegistry(): Record<string, CatalogToolDefinition>;
+export declare function catalogCategories(): string[];
+export declare function catalogCounts(): {
+  total: number;
+  eligible: number;
+  excluded: number;
+};
+export declare function toolArgsJsonSchema(name: string): Record<string, unknown>;
+export declare function mcpToolDescription(name: string): string;
+export declare function isCatalogToolError(value: unknown): value is CatalogToolError;
+export declare function executeCatalogTool(
+  name: string,
+  args: unknown,
+  context: CatalogCallContext
+): Promise<unknown>;
+export declare function executeCatalogToolWithTrace(
+  name: string,
+  args: unknown,
+  context: CatalogCallContext
+): Promise<CatalogExecutionResult>;
+export declare function shapeMcpToolResult(name: string, value: unknown): unknown;
+
+export declare function runMcpServer(
+  apiUrlFlag?: string,
+  categories?: string,
+  workspaceIdFlag?: string
+): Promise<void>;