@personaai/runtime 0.8.0 → 0.9.1

package/dist/index.d.cts

@@ -1,4 +1,6 @@
 import { ChatMessageInput, CreateRestToolInput, LogLevel, Logger } from '@personaai/sdk';
+import { RcpTool } from 'rcp-sdk';
+export { RcpTool } from 'rcp-sdk';
 
 type RuntimeMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 /** A single uploaded file — present on `RuntimeRequest.file` for a multipart `POST /files`. */
@@ -214,6 +216,25 @@ interface RestToolsManifestOptions {
      */
     authToken?: string;
 }
+/**
+ * Serves a list of code-defined RCP (REST Connector Protocol, npm `rcp-sdk`)
+ * tools as a conformant `{ rcpVersion, auth, tools }` manifest at
+ * `GET {mountPath}/rcp/manifest` — register that URL as an RCP source and
+ * any RCP client (Persona included) discovers/calls these tools live.
+ * Independent of {@link RestToolsManifestOptions} — unrelated protocols,
+ * both servable from the same runtime instance if you want both.
+ */
+interface RcpManifestOptions {
+    /** RCP tool definitions to serve — build each with `defineTool` from `rcp-sdk/server`. */
+    tools: RcpTool[];
+    /**
+     * Required `Authorization: Bearer <token>` value the manifest route
+     * checks incoming requests against. Omitting this leaves the route open
+     * (`auth: { type: 'none' }` in the served manifest) — 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;
@@ -258,6 +279,8 @@ interface CreateRuntimeOptions {
     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;
+    /** Serves a conformant RCP manifest for any RCP client to discover. See {@link RcpManifestOptions}. Unset by default — the route only exists when this is provided. */
+    rcpManifest?: RcpManifestOptions;
     /** 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. */
@@ -286,4 +309,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 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 };
+export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type RcpManifestOptions, 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,6 @@
 import { ChatMessageInput, CreateRestToolInput, LogLevel, Logger } from '@personaai/sdk';
+import { RcpTool } from 'rcp-sdk';
+export { RcpTool } from 'rcp-sdk';
 
 type RuntimeMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 /** A single uploaded file — present on `RuntimeRequest.file` for a multipart `POST /files`. */
@@ -214,6 +216,25 @@ interface RestToolsManifestOptions {
      */
     authToken?: string;
 }
+/**
+ * Serves a list of code-defined RCP (REST Connector Protocol, npm `rcp-sdk`)
+ * tools as a conformant `{ rcpVersion, auth, tools }` manifest at
+ * `GET {mountPath}/rcp/manifest` — register that URL as an RCP source and
+ * any RCP client (Persona included) discovers/calls these tools live.
+ * Independent of {@link RestToolsManifestOptions} — unrelated protocols,
+ * both servable from the same runtime instance if you want both.
+ */
+interface RcpManifestOptions {
+    /** RCP tool definitions to serve — build each with `defineTool` from `rcp-sdk/server`. */
+    tools: RcpTool[];
+    /**
+     * Required `Authorization: Bearer <token>` value the manifest route
+     * checks incoming requests against. Omitting this leaves the route open
+     * (`auth: { type: 'none' }` in the served manifest) — 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;
@@ -258,6 +279,8 @@ interface CreateRuntimeOptions {
     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;
+    /** Serves a conformant RCP manifest for any RCP client to discover. See {@link RcpManifestOptions}. Unset by default — the route only exists when this is provided. */
+    rcpManifest?: RcpManifestOptions;
     /** 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. */
@@ -286,4 +309,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 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 };
+export { type CreateRuntimeOptions, type ErrorContext, type FileUploadContext, type MemoryWriteContext, RUNTIME_VERSION, type RcpManifestOptions, 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

@@ -226,6 +226,26 @@ var restToolsManifestRoute = async (request, ctx) => {
   return json(200, { tools: manifest.tools });
 };
 
+// src/routes/rcpManifest.ts
+var rcpManifestRoute = async (request, ctx) => {
+  const manifest = ctx.rcpManifest;
+  if (!manifest) {
+    throw new RuntimeHttpError(404, "NOT_FOUND", "No RCP 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, {
+    rcpVersion: "0.1",
+    auth: manifest.authToken ? { type: "header", header: "Authorization", scheme: "Bearer" } : { type: "none" },
+    tools: manifest.tools
+  });
+};
+
 // src/runDriver.ts
 import { EventType } from "@personaai/sdk";
 function formatSseFrame(event) {
@@ -736,7 +756,11 @@ var createVoiceSession = async (request, ctx) => {
   const body = requireBodyObject(request.body);
   const agentId = requireStringField(body, "agentId");
   const threadId = typeof body.threadId === "string" && body.threadId ? body.threadId : void 0;
-  const ticket = await ctx.client.voice.createSession(agentId, threadId ? { threadId } : {});
+  const contextOverride = typeof body.contextOverride === "string" && body.contextOverride ? body.contextOverride : void 0;
+  const ticket = await ctx.client.voice.createSession(agentId, {
+    ...threadId ? { threadId } : {},
+    ...contextOverride ? { contextOverride } : {}
+  });
   await ctx.hooks?.onVoiceSessionCreate?.({
     userId: request.userId,
     agentId,
@@ -1459,6 +1483,14 @@ function createRuntime(options) {
       requiresAuth: false
     });
   }
+  if (options.rcpManifest) {
+    routes.push({
+      method: "GET",
+      pattern: ["rcp", "manifest"],
+      handler: rcpManifestRoute,
+      requiresAuth: false
+    });
+  }
   const mode = resolveMode(options);
   const heartbeatIntervalMs = options.heartbeatIntervalMs ?? 15e3;
   const runGraceMs = options.runGraceMs ?? DEFAULT_RUN_GRACE_MS;
@@ -1625,7 +1657,8 @@ function createRuntime(options) {
         runs,
         capabilities,
         logger: routeLogger,
-        restToolsManifest: options.restToolsManifest
+        restToolsManifest: options.restToolsManifest,
+        rcpManifest: options.rcpManifest
       });
       const durationMs = Date.now() - startMs;
       logger.info("handle succeeded", {