@superblocksteam/sdk-api 2.0.93 → 2.0.94-next.0

package/dist/runtime/streaming-context.js

@@ -4,8 +4,8 @@
  * Creates the context object for streaming API functions, providing
  * access to integrations (with streaming support), logging, and environment.
  */
-import { createClient } from '../integrations/registry.js';
-import { createDefaultLogger } from './logger.js';
+import { createClient, } from "../integrations/registry.js";
+import { createDefaultLogger } from "./logger.js";
 /**
  * Creates a streaming API execution context.
  *

package/dist/runtime/streaming-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"streaming-context.js","sourceRoot":"","sources":["../../src/runtime/streaming-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,YAAY,EAAmD,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA6ClD;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAsC;IAEtC,MAAM,EACJ,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,GAAG,EACH,IAAI,EACJ,MAAM,GACP,GAAG,OAAO,CAAC;IAEZ,wCAAwC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiC,CAAC;IAE7D,gBAAgB;IAChB,MAAM,GAAG,GAAG,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEvD;;;OAGG;IACH,SAAS,cAAc,CAAC,EAAU,EAAE,QAAgB;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEpC,4CAA4C;QAC5C,MAAM,aAAa,GAAkB,CACnC,OAAgC,EAChC,QAAkC,EAClC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEzC,wCAAwC;QACxC,MAAM,sBAAsB,GAAuC,qBAAqB;YACtF,CAAC,CAAC,CAAC,OAAgC,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,EAAE,OAAO,CAAC;YAC1E,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,YAAY,GAAsB,MAAM,IAAI;YAChD,EAAE;YACF,IAAI,EAAE,EAAE;YACR,QAAQ;YACR,aAAa,EAAE,EAAE;SAClB,CAAC;QAEF,uCAAuC;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,aAAa;YAC3B,qBAAqB,EAAE,sBAAsB;SAC9C,CAAC,CAAC;QAEH,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kDAAkD;IAClD,MAAM,kBAAkB,GAA0C,EAAE,CAAC;IAErE,KAAK,MAAM,WAAW,IAAI,uBAAuB,EAAE,CAAC;QAClD,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,EAAE;YACzD,GAAG,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC;YAC/D,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,YAAY,EAAE,kBAEG;QACjB,GAAG;QACH,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9B,IAAI;KACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"streaming-context.js","sourceRoot":"","sources":["../../src/runtime/streaming-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,EACL,YAAY,GAGb,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA6ClD;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAsC;IAEtC,MAAM,EACJ,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,GAAG,EACH,IAAI,EACJ,MAAM,GACP,GAAG,OAAO,CAAC;IAEZ,wCAAwC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiC,CAAC;IAE7D,gBAAgB;IAChB,MAAM,GAAG,GAAG,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEvD;;;OAGG;IACH,SAAS,cAAc,CAAC,EAAU,EAAE,QAAgB;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEpC,4CAA4C;QAC5C,MAAM,aAAa,GAAkB,CACnC,OAAgC,EAChC,QAAkC,EAClC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEzC,wCAAwC;QACxC,MAAM,sBAAsB,GAC1B,qBAAqB;YACnB,CAAC,CAAC,CAAC,OAAgC,EAAE,EAAE,CACnC,qBAAqB,CAAC,EAAE,EAAE,OAAO,CAAC;YACtC,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,YAAY,GAAsB,MAAM,IAAI;YAChD,EAAE;YACF,IAAI,EAAE,EAAE;YACR,QAAQ;YACR,aAAa,EAAE,EAAE;SAClB,CAAC;QAEF,uCAAuC;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,aAAa;YAC3B,qBAAqB,EAAE,sBAAsB;SAC9C,CAAC,CAAC;QAEH,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kDAAkD;IAClD,MAAM,kBAAkB,GAA0C,EAAE,CAAC;IAErE,KAAK,MAAM,WAAW,IAAI,uBAAuB,EAAE,CAAC;QAClD,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,EAAE;YACzD,GAAG,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC;YAC/D,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,YAAY,EAAE,kBAEG;QACjB,GAAG;QACH,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9B,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/runtime/streaming-executor.d.ts

@@ -4,10 +4,10 @@
  * Provides the entry point for executing compiled streaming APIs,
  * handling input validation, chunk validation, and error management.
  */
-import type { CompiledStreamingApi } from '../api/streaming.js';
-import type { IntegrationConfig } from '../integrations/types.js';
-import type { ApiUser } from '../types.js';
-import { type ErrorCodeType } from './errors.js';
+import type { CompiledStreamingApi } from "../api/streaming.js";
+import type { IntegrationConfig } from "../integrations/types.js";
+import type { ApiUser } from "../types.js";
+import { type ErrorCodeType } from "./errors.js";
 /**
  * Request to execute a streaming API.
  */

package/dist/runtime/streaming-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming-executor.d.ts","sourceRoot":"","sources":["../../src/runtime/streaming-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IAEf,2CAA2C;IAC3C,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAElC,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,0DAA0D;IAC1D,IAAI,EAAE,OAAO,CAAC;IAEd;;;;;;;OAOG;IACH,YAAY,EAAE,CACZ,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,CACtB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,aAAa,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM,GAAG,OAAO;IACrD;;;;;OAKG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhD;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GACjC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAC1E,GAAG,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,EAAE,0BAA0B,EACnC,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAkHpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,2BAA2B,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EACnF,GAAG,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,EAAE,0BAA0B,GAClC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAuDzC"}
+{"version":3,"file":"streaming-executor.d.ts","sourceRoot":"","sources":["../../src/runtime/streaming-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IAEf,2CAA2C;IAC3C,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAElC,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,0DAA0D;IAC1D,IAAI,EAAE,OAAO,CAAC;IAEd;;;;;;;OAOG;IACH,YAAY,EAAE,CACZ,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,CACtB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,aAAa,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM,GAAG,OAAO;IACrD;;;;;OAKG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhD;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GACjC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAC1E,GAAG,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,EAAE,0BAA0B,EACnC,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAkHpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,2BAA2B,CAChD,MAAM,GAAG,OAAO,EAChB,MAAM,GAAG,OAAO,EAEhB,GAAG,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,EAAE,0BAA0B,GAClC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAuDzC"}

package/dist/runtime/streaming-executor.js

@@ -4,9 +4,9 @@
  * Provides the entry point for executing compiled streaming APIs,
  * handling input validation, chunk validation, and error management.
  */
-import { getIntegrationDeclarations } from '../integrations/declarations.js';
-import { createStreamingApiContext } from './streaming-context.js';
-import { SdkError, InputValidationError, ExecutionError, ErrorCode, } from './errors.js';
+import { getIntegrationDeclarations } from "../integrations/declarations.js";
+import { createStreamingApiContext, } from "./streaming-context.js";
+import { SdkError, InputValidationError, ExecutionError, ErrorCode, } from "./errors.js";
 /**
  * Executes a compiled streaming API with the given request.
  *
@@ -60,7 +60,7 @@ export async function executeStreamingApi(api, request, callbacks) {
         if (!inputResult.success) {
             const error = {
                 code: ErrorCode.INPUT_VALIDATION,
-                message: 'Input validation failed',
+                message: "Input validation failed",
                 details: { issues: inputResult.error.issues },
                 chunksYielded: 0,
             };
@@ -182,7 +182,7 @@ export async function* createStreamingApiGenerator(api, request) {
     // Validate input
     const inputResult = api.inputSchema.safeParse(request.input);
     if (!inputResult.success) {
-        throw new InputValidationError('Input validation failed', {
+        throw new InputValidationError("Input validation failed", {
             issues: inputResult.error.issues,
         });
     }

package/dist/runtime/streaming-executor.js.map

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

package/dist/types.d.ts

@@ -3,8 +3,8 @@
  *
  * This module provides the public types used to define TypeScript-based APIs.
  */
-import type { z } from 'zod';
-import type { IntegrationRef, AnyIntegrationRef, IntegrationsMap } from './integrations/declarations.js';
+import type { z } from "zod";
+import type { IntegrationRef, AnyIntegrationRef, IntegrationsMap } from "./integrations/declarations.js";
 /**
  * Configuration for defining a TypeScript-based API.
  *
@@ -53,6 +53,13 @@ export interface ApiConfig<TInput extends z.ZodType, TOutput extends z.ZodType,
      * Used for identification in execution logs and debugging.
      */
     name: string;
+    /**
+     * Plain-language summary of what this API does and which integrations it uses,
+     * written for a non-technical audience.
+     *
+     * This field is auto-generated by the AI agent when creating or editing an API.
+     */
+    description?: string;
     /**
      * Integration declarations for this API.
      *
@@ -111,7 +118,7 @@ export interface ApiContext<TIntegrations extends Record<string, AnyIntegrationR
     /**
      * Typed integration clients declared in the API config.
      *
-     * Access integrations by the key you defined in the `integrations` config.
+     * Access each integration by the name (key) you declared: `ctx.integrations.<name>`.
      * Each client is fully typed based on the declaration function used.
      *
      * @example

package/dist/types.d.ts.map

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

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@superblocksteam/sdk-api",
-  "version": "2.0.93",
+  "version": "2.0.94-next.0",
   "description": "Superblocks SDK for TypeScript-based API definitions",
   "license": "Superblocks Community Software License",
-  "type": "module",
-  "engines": {
-    "node": ">=20",
-    "npm": ">=10.x"
-  },
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "files": [
     "dist",
     "src",
     "README.md"
   ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
   "dependencies": {
     "@superblocksteam/types": "1.196.0",
     "zod": "^3.23.8"
@@ -33,10 +33,10 @@
     "uuid": "^9.0.0",
     "vitest": "^2.0.0"
   },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org"
+  "engines": {
+    "node": ">=20",
+    "npm": ">=10.x"
   },
-  "sideEffects": false,
   "scripts": {
     "build": "tsc --build",
     "clean": "rm -rf ./dist *tsbuildinfo",

package/src/api/definition.test.ts

@@ -1,12 +1,14 @@
 /**
- * Tests for API definition utility types.
+ * Tests for API definition utility types and entry point mechanism.
  */
 
 /* eslint-disable @typescript-eslint/no-unused-vars */
-import { describe, it, expectTypeOf } from "vitest";
+import { describe, it, expect, expectTypeOf } from "vitest";
 import { z } from "zod";
 import {
   api,
+  __setEntryPoint,
+  consumeEntryPoint,
   type ExtractApiInput,
   type ExtractApiOutput,
 } from "./definition.js";
@@ -313,3 +315,64 @@ describe("ExtractApiInput and ExtractApiOutput together", () => {
     }>();
   });
 });
+
+describe("entryPoint mechanism", () => {
+  it("api() has no entryPoint when __setEntryPoint was not called", () => {
+    const compiled = api({
+      name: "NoEntryPoint",
+      input: z.object({}),
+      output: z.object({ ok: z.boolean() }),
+      async run() {
+        return { ok: true };
+      },
+    });
+
+    expect(compiled.entryPoint).toBeUndefined();
+  });
+
+  it("api() picks up entryPoint set via __setEntryPoint", () => {
+    __setEntryPoint("server/apis/GetUsers/api.ts");
+    const compiled = api({
+      name: "GetUsers",
+      input: z.object({}),
+      output: z.object({ users: z.array(z.string()) }),
+      async run() {
+        return { users: [] };
+      },
+    });
+
+    expect(compiled.entryPoint).toBe("server/apis/GetUsers/api.ts");
+  });
+
+  it("consumeEntryPoint clears the pending value", () => {
+    __setEntryPoint("server/apis/Temp/api.ts");
+    const first = consumeEntryPoint();
+    const second = consumeEntryPoint();
+
+    expect(first).toBe("server/apis/Temp/api.ts");
+    expect(second).toBeUndefined();
+  });
+
+  it("entryPoint is consumed once — second api() call gets undefined", () => {
+    __setEntryPoint("server/apis/First/api.ts");
+    const first = api({
+      name: "First",
+      input: z.object({}),
+      output: z.object({}),
+      async run() {
+        return {};
+      },
+    });
+    const second = api({
+      name: "Second",
+      input: z.object({}),
+      output: z.object({}),
+      async run() {
+        return {};
+      },
+    });
+
+    expect(first.entryPoint).toBe("server/apis/First/api.ts");
+    expect(second.entryPoint).toBeUndefined();
+  });
+});

package/src/api/definition.ts

@@ -50,6 +50,25 @@ import {
   type IntegrationDeclaration,
 } from "../integrations/declarations.js";
 
+// ---------------------------------------------------------------------------
+// Entry point setter — used by the Vite plugin to stamp the source file path
+// onto the next api()/streamingApi() call. ESM top-level execution is
+// synchronous, so the prepended __setEntryPoint() always runs before api().
+// ---------------------------------------------------------------------------
+
+let __pendingEntryPoint: string | undefined;
+
+/** Called by the Vite plugin to set the entry point for the next api() call. */
+export function __setEntryPoint(entryPoint: string): void {
+  __pendingEntryPoint = entryPoint;
+}
+
+export function consumeEntryPoint(): string | undefined {
+  const ep = __pendingEntryPoint;
+  __pendingEntryPoint = undefined;
+  return ep;
+}
+
 /**
  * A compiled API definition ready for execution.
  *
@@ -60,6 +79,14 @@ export interface CompiledApi<TInput = unknown, TOutput = unknown> {
   /** Name of the API for identification in logs and debugging */
   readonly name: string;
 
+  /** Plain-language summary of what this API does */
+  readonly description?: string;
+  /**
+   * Source file path relative to the app root (e.g. "server/apis/GetUsers/api.ts").
+   * Injected automatically by the Vite plugin — not authored by the user.
+   */
+  readonly entryPoint?: string;
+
   /** Zod schema for validating inputs */
   readonly inputSchema: z.ZodType<TInput>;
 
@@ -73,7 +100,10 @@ export interface CompiledApi<TInput = unknown, TOutput = unknown> {
    * @param input - Validated input parameters
    * @returns Promise resolving to the output
    */
-  readonly run: (ctx: ApiContext<Record<string, AnyIntegrationRef>>, input: TInput) => Promise<TOutput>;
+  readonly run: (
+    ctx: ApiContext<Record<string, AnyIntegrationRef>>,
+    input: TInput,
+  ) => Promise<TOutput>;
 
   /**
    * Declared integrations for upfront authentication.
@@ -165,6 +195,8 @@ export function api<
 
   const compiled: CompiledApi<z.infer<TInput>, z.infer<TOutput>> = {
     name: config.name,
+    description: config.description,
+    entryPoint: consumeEntryPoint(),
     inputSchema: config.input,
     outputSchema: config.output,
     run: config.run as (

package/src/api/index.ts

@@ -2,9 +2,9 @@
  * API definition module.
  */
 
-export { api } from './definition.js';
-export type { CompiledApi } from './definition.js';
+export { api, __setEntryPoint } from "./definition.js";
+export type { CompiledApi } from "./definition.js";
 
 // Streaming API support
-export { streamingApi, isStreamingApi } from './streaming.js';
-export type { StreamingApiConfig, CompiledStreamingApi } from './streaming.js';
+export { streamingApi, isStreamingApi } from "./streaming.js";
+export type { StreamingApiConfig, CompiledStreamingApi } from "./streaming.js";