@personaai/runtime 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ChatMessageInput, LogLevel, Logger } from '@personaai/sdk';
+import { ChatMessageInput, CreateRestToolInput, LogLevel, Logger } from '@personaai/sdk';
 
 type RuntimeMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 /** A single uploaded file — present on `RuntimeRequest.file` for a multipart `POST /files`. */
@@ -116,6 +116,8 @@ interface MemoryWriteContext {
 interface VoiceSessionCreateContext {
     userId: string;
     agentId: string;
+    /** Set when the session resumed an existing conversation (optional `threadId` on the request). */
+    threadId?: string;
 }
 /**
  * Lifecycle hooks — the host application's voice inside the runtime's
@@ -146,6 +148,13 @@ interface RuntimeHooks {
     onVoiceSessionCreate?(ctx: VoiceSessionCreateContext): void | Promise<void>;
 }
 
+/**
+ * One REST tool definition served by the manifest route — identical to
+ * `CreateRestToolInput` from `@personaai/sdk@^0.7.0` (also `defineRestTool`'s
+ * return type from `@personaai/sdk/rest-tools`), aliased under this name for
+ * clarity at the call site (`createRuntime({ restToolsManifest: { tools } })`).
+ */
+type RestToolManifestEntry = CreateRestToolInput;
 /**
  * The single point of contact between the host's auth world and the
  * runtime's world. Receives the inbound request (with `userId: null`) and
@@ -184,6 +193,27 @@ interface RuntimeCapabilities {
     /** The Architect co-pilot — builds/edits Agents on the caller's behalf via tool calls. @default false */
     architect?: boolean;
 }
+/**
+ * Serves a list of code-defined REST tools (built with `defineRestTool`
+ * from `@personaai/sdk/rest-tools`) as a JSON manifest at
+ * `GET {mountPath}/rest-tools/manifest` — register that URL in the Persona
+ * dashboard as a REST Tool Source and it discovers/calls these tools live,
+ * the same way it discovers an MCP server's tools. This is host-side
+ * static data the runtime *serves*, not a Persona-proxy capability — it
+ * never calls `PersonaClient` and works even with no `resolveUser`
+ * traffic at all.
+ */
+interface RestToolsManifestOptions {
+    /** REST tool definitions to serve — build each with `defineRestTool` from `@personaai/sdk/rest-tools`, or pass a plain object of the same shape. */
+    tools: RestToolManifestEntry[];
+    /**
+     * Required `Authorization: Bearer <token>` value the manifest route
+     * checks incoming requests against — must match the API Key configured
+     * on the Persona-side REST Tool Source. Omitting this leaves the route
+     * open (no auth) — only acceptable for local/dev testing.
+     */
+    authToken?: string;
+}
 interface CreateRuntimeOptions {
     /** Base URL of the Persona Developer Platform API, e.g. "https://api.persona.hasanraiyan.me". */
     baseUrl: string;
@@ -226,6 +256,8 @@ interface CreateRuntimeOptions {
     maxTrackedRuns?: number;
     /** Opt-in switches for Project-level admin surface. See {@link RuntimeCapabilities} — everything defaults to off. */
     capabilities?: RuntimeCapabilities;
+    /** Serves a code-defined REST tool list for a Persona REST Tool Source to discover. See {@link RestToolsManifestOptions}. Unset by default — the route only exists when this is provided. */
+    restToolsManifest?: RestToolsManifestOptions;
     /** Log level for the runtime — off by default. Overrides the global level set via `setLogLevel()` from `@personaai/sdk`. */
     logLevel?: LogLevel;
     /** Custom logger instance — when provided, `logLevel` is ignored. */
@@ -254,4 +286,4 @@ declare class RuntimeHttpError extends Error {
 
 declare const RUNTIME_VERSION = "0.5.4";
 
-export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, type VoiceSessionCreateContext, createRuntime };
+export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RestToolManifestEntry, type RestToolsManifestOptions, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, type VoiceSessionCreateContext, createRuntime };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ChatMessageInput, LogLevel, Logger } from '@personaai/sdk';
+import { ChatMessageInput, CreateRestToolInput, LogLevel, Logger } from '@personaai/sdk';
 
 type RuntimeMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 /** A single uploaded file — present on `RuntimeRequest.file` for a multipart `POST /files`. */
@@ -116,6 +116,8 @@ interface MemoryWriteContext {
 interface VoiceSessionCreateContext {
     userId: string;
     agentId: string;
+    /** Set when the session resumed an existing conversation (optional `threadId` on the request). */
+    threadId?: string;
 }
 /**
  * Lifecycle hooks — the host application's voice inside the runtime's
@@ -146,6 +148,13 @@ interface RuntimeHooks {
     onVoiceSessionCreate?(ctx: VoiceSessionCreateContext): void | Promise<void>;
 }
 
+/**
+ * One REST tool definition served by the manifest route — identical to
+ * `CreateRestToolInput` from `@personaai/sdk@^0.7.0` (also `defineRestTool`'s
+ * return type from `@personaai/sdk/rest-tools`), aliased under this name for
+ * clarity at the call site (`createRuntime({ restToolsManifest: { tools } })`).
+ */
+type RestToolManifestEntry = CreateRestToolInput;
 /**
  * The single point of contact between the host's auth world and the
  * runtime's world. Receives the inbound request (with `userId: null`) and
@@ -184,6 +193,27 @@ interface RuntimeCapabilities {
     /** The Architect co-pilot — builds/edits Agents on the caller's behalf via tool calls. @default false */
     architect?: boolean;
 }
+/**
+ * Serves a list of code-defined REST tools (built with `defineRestTool`
+ * from `@personaai/sdk/rest-tools`) as a JSON manifest at
+ * `GET {mountPath}/rest-tools/manifest` — register that URL in the Persona
+ * dashboard as a REST Tool Source and it discovers/calls these tools live,
+ * the same way it discovers an MCP server's tools. This is host-side
+ * static data the runtime *serves*, not a Persona-proxy capability — it
+ * never calls `PersonaClient` and works even with no `resolveUser`
+ * traffic at all.
+ */
+interface RestToolsManifestOptions {
+    /** REST tool definitions to serve — build each with `defineRestTool` from `@personaai/sdk/rest-tools`, or pass a plain object of the same shape. */
+    tools: RestToolManifestEntry[];
+    /**
+     * Required `Authorization: Bearer <token>` value the manifest route
+     * checks incoming requests against — must match the API Key configured
+     * on the Persona-side REST Tool Source. Omitting this leaves the route
+     * open (no auth) — only acceptable for local/dev testing.
+     */
+    authToken?: string;
+}
 interface CreateRuntimeOptions {
     /** Base URL of the Persona Developer Platform API, e.g. "https://api.persona.hasanraiyan.me". */
     baseUrl: string;
@@ -226,6 +256,8 @@ interface CreateRuntimeOptions {
     maxTrackedRuns?: number;
     /** Opt-in switches for Project-level admin surface. See {@link RuntimeCapabilities} — everything defaults to off. */
     capabilities?: RuntimeCapabilities;
+    /** Serves a code-defined REST tool list for a Persona REST Tool Source to discover. See {@link RestToolsManifestOptions}. Unset by default — the route only exists when this is provided. */
+    restToolsManifest?: RestToolsManifestOptions;
     /** Log level for the runtime — off by default. Overrides the global level set via `setLogLevel()` from `@personaai/sdk`. */
     logLevel?: LogLevel;
     /** Custom logger instance — when provided, `logLevel` is ignored. */
@@ -254,4 +286,4 @@ declare class RuntimeHttpError extends Error {
 
 declare const RUNTIME_VERSION = "0.5.4";
 
-export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, type VoiceSessionCreateContext, createRuntime };
+export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type ResolveUser, type RestToolManifestEntry, type RestToolsManifestOptions, type RunContext, type RunResult, type Runtime, type RuntimeBinaryResponse, type RuntimeBufferedResponse, type RuntimeCapabilities, type RuntimeHooks, RuntimeHttpError, type RuntimeMethod, type RuntimeRequest, type RuntimeResponse, type RuntimeStreamResponse, type RuntimeUploadedFile, type ThreadCreateContext, type ToolCallContext, type VoiceSessionCreateContext, createRuntime };

package/dist/index.js

@@ -161,6 +161,71 @@ var healthRoute = async (_request, ctx) => {
   };
 };
 
+// src/routeHelpers.ts
+function json(status, value) {
+  return {
+    kind: "buffered",
+    status,
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify(value)
+  };
+}
+function noContent() {
+  return { kind: "buffered", status: 204, headers: {}, body: "" };
+}
+function requireParam(params, name) {
+  const value = params[name];
+  if (!value) {
+    throw new RuntimeHttpError(400, "INVALID_REQUEST", `"${name}" path parameter is required.`);
+  }
+  return value;
+}
+function requireQueryParam(query, name) {
+  const value = query[name];
+  if (!value) {
+    throw new RuntimeHttpError(400, "INVALID_REQUEST", `"${name}" query parameter is required.`);
+  }
+  return value;
+}
+function toInt(value) {
+  if (value === void 0) return void 0;
+  const parsed = Number.parseInt(value, 10);
+  return Number.isNaN(parsed) ? void 0 : parsed;
+}
+function requireBodyObject(body) {
+  if (typeof body !== "object" || body === null) {
+    throw new RuntimeHttpError(400, "INVALID_REQUEST", "Request body must be a JSON object.");
+  }
+  return body;
+}
+function requireStringField(body, field) {
+  const value = body[field];
+  if (typeof value !== "string" || value.length === 0) {
+    throw new RuntimeHttpError(
+      400,
+      "INVALID_REQUEST",
+      `"${field}" is required and must be a string.`
+    );
+  }
+  return value;
+}
+
+// src/routes/restToolsManifest.ts
+var restToolsManifestRoute = async (request, ctx) => {
+  const manifest = ctx.restToolsManifest;
+  if (!manifest) {
+    throw new RuntimeHttpError(404, "NOT_FOUND", "No REST tools manifest is configured.");
+  }
+  if (manifest.authToken) {
+    const header = request.headers.authorization;
+    const expected = `Bearer ${manifest.authToken}`;
+    if (header !== expected) {
+      throw new RuntimeHttpError(401, "UNAUTHORIZED", "Invalid or missing manifest bearer token.");
+    }
+  }
+  return json(200, { tools: manifest.tools });
+};
+
 // src/runDriver.ts
 import { EventType } from "@personaai/sdk";
 function formatSseFrame(event) {
@@ -619,55 +684,6 @@ function createResumeRoute(expectedKind) {
   };
 }
 
-// src/routeHelpers.ts
-function json(status, value) {
-  return {
-    kind: "buffered",
-    status,
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify(value)
-  };
-}
-function noContent() {
-  return { kind: "buffered", status: 204, headers: {}, body: "" };
-}
-function requireParam(params, name) {
-  const value = params[name];
-  if (!value) {
-    throw new RuntimeHttpError(400, "INVALID_REQUEST", `"${name}" path parameter is required.`);
-  }
-  return value;
-}
-function requireQueryParam(query, name) {
-  const value = query[name];
-  if (!value) {
-    throw new RuntimeHttpError(400, "INVALID_REQUEST", `"${name}" query parameter is required.`);
-  }
-  return value;
-}
-function toInt(value) {
-  if (value === void 0) return void 0;
-  const parsed = Number.parseInt(value, 10);
-  return Number.isNaN(parsed) ? void 0 : parsed;
-}
-function requireBodyObject(body) {
-  if (typeof body !== "object" || body === null) {
-    throw new RuntimeHttpError(400, "INVALID_REQUEST", "Request body must be a JSON object.");
-  }
-  return body;
-}
-function requireStringField(body, field) {
-  const value = body[field];
-  if (typeof value !== "string" || value.length === 0) {
-    throw new RuntimeHttpError(
-      400,
-      "INVALID_REQUEST",
-      `"${field}" is required and must be a string.`
-    );
-  }
-  return value;
-}
-
 // src/routes/threads.ts
 var listThreads = async (request, ctx) => {
   const items = await ctx.client.threads.list({
@@ -719,10 +735,12 @@ var resetThread = async (_request, ctx) => {
 var createVoiceSession = async (request, ctx) => {
   const body = requireBodyObject(request.body);
   const agentId = requireStringField(body, "agentId");
-  const ticket = await ctx.client.voice.createSession(agentId);
+  const threadId = typeof body.threadId === "string" && body.threadId ? body.threadId : void 0;
+  const ticket = await ctx.client.voice.createSession(agentId, threadId ? { threadId } : {});
   await ctx.hooks?.onVoiceSessionCreate?.({
     userId: request.userId,
-    agentId
+    agentId,
+    threadId
   });
   return json(201, ticket);
 };
@@ -1433,6 +1451,14 @@ function createRuntime(options) {
   );
   const capabilities = resolveCapabilities(options.capabilities);
   const routes = buildRoutes(capabilities);
+  if (options.restToolsManifest) {
+    routes.push({
+      method: "GET",
+      pattern: ["rest-tools", "manifest"],
+      handler: restToolsManifestRoute,
+      requiresAuth: false
+    });
+  }
   const mode = resolveMode(options);
   const heartbeatIntervalMs = options.heartbeatIntervalMs ?? 15e3;
   const runGraceMs = options.runGraceMs ?? DEFAULT_RUN_GRACE_MS;
@@ -1598,7 +1624,8 @@ function createRuntime(options) {
         heartbeatIntervalMs,
         runs,
         capabilities,
-        logger: routeLogger
+        logger: routeLogger,
+        restToolsManifest: options.restToolsManifest
       });
       const durationMs = Date.now() - startMs;
       logger.info("handle succeeded", {