@pinecall/protocol 0.5.0 → 0.6.1

package/dist/generated/rest.js

@@ -428,15 +428,13 @@ export const KnowledgeScoreSchema = z.strictObject({
     misses: z.array(GoldenMissSchema),
 });
 /**
- * PUT /v1/knowledge/{base}, the answer: which base, how many chunks it became, how long that took,
- * and what its whole files weigh on every call.
+ * PUT /v1/knowledge/{base}, the answer: which base, how many chunks it became, and how long that
+ * took.
  */
 export const KnowledgePushedSchema = z.strictObject({
     base: z.string(),
     chunks: z.int(),
     took_ms: z.number(),
-    whole_tokens: z.int().nullish(),
-    notice: z.string().nullable().nullish(),
 });
 /** One knowledge base as the list draws it: its name, its size, and when it was last pushed. */
 export const KnowledgeBaseSchema = z.strictObject({
@@ -660,9 +658,8 @@ export const OutboundProvisionedSchema = z.strictObject({
     address: z.string().nullish(),
 });
 /**
- * An agent's tuning: what the org set over what the app declared, per world and per corner. Every
- * field is optional; one left out is not set, and what the app declared — or the runtime's own
- * default — stands for it.
+ * An agent's settings: what the org set, per world and per corner. Every field is optional; one
+ * left out is not set, and the runtime's own default stands for it.
  */
 export const TuningBodySchema = z.strictObject({
     voice: z.string().nullish(),
@@ -674,7 +671,8 @@ export const TuningBodySchema = z.strictObject({
     hangup: HangupConfigSchema.nullish(),
     turn: TurnConfigSchema.nullish(),
     memory: MemoryConfigSchema.nullish(),
-    knowledge: z.array(DocsConfigSchema).nullish(),
+    knowledge: z.string().nullish(),
+    bases: z.array(DocsConfigSchema).nullish(),
 });
 /**
  * One kept version of an agent's tuning: whose corner, which version, who set it and when, and
@@ -781,6 +779,46 @@ export const CallTuningSchema = z.strictObject({
     config: TuningRowSchema.nullable(),
     lexicon: LexiconRowSchema.nullable(),
 });
+/** One file of a base as the list draws it. */
+export const KnowledgeFileRowSchema = z.strictObject({
+    path: z.string(),
+    chars: z.int(),
+    chunks: z.int(),
+    pushed_at: z.number(),
+});
+/**
+ * GET /v1/knowledge/{base}: every file of the base, by path, with its size and what it became.
+ * Never the text: one file is read at a time.
+ */
+export const KnowledgeFilesSchema = z.strictObject({
+    base: z.string(),
+    kept: z.boolean(),
+    files: z.array(KnowledgeFileRowSchema),
+});
+/** GET /v1/knowledge/{base}/files/{path}: one file, text and all. */
+export const KnowledgeFileReadSchema = z.strictObject({
+    path: z.string(),
+    text: z.string(),
+    chunks: z.int(),
+    pushed_at: z.number(),
+});
+/**
+ * PUT /v1/knowledge/{base}/files/{path}, the body: the file's whole text. New under that path, or
+ * replaced in place; the base is begun when there is none.
+ */
+export const KnowledgeFilePutSchema = z.strictObject({
+    text: z.string(),
+});
+/**
+ * PUT /v1/knowledge/{base}/files/{path}, the answer: which file, how many chunks it became, and
+ * how long that took.
+ */
+export const KnowledgeFilePushedSchema = z.strictObject({
+    base: z.string(),
+    path: z.string(),
+    chunks: z.int(),
+    took_ms: z.number(),
+});
 /** One base and the agents whose settings attach it. */
 export const KnowledgeUseSchema = z.strictObject({
     base: z.string(),
@@ -793,3 +831,34 @@ export const KnowledgeUseSchema = z.strictObject({
 export const KnowledgeUsesSchema = z.strictObject({
     bases: z.array(KnowledgeUseSchema),
 });
+/**
+ * One synthetic caller of an agent, kept by the gateway: what they want, how they talk, and what
+ * they may state about themselves. A model plays them turn by turn — there is no script — for
+ * `pinecall simulate` and the console's Simulations.
+ */
+export const PersonaSchema = z.strictObject({
+    name: z.string(),
+    about: z.string(),
+    goal: z.string(),
+    style: z.string(),
+    facts: z.record(z.string(), z.string()),
+    state: z.record(z.string(), z.unknown()),
+    author: z.string(),
+    set_at: z.number(),
+});
+/** GET /v1/agents/{slug}/personas: every caller written for this agent, by name. */
+export const PersonaListSchema = z.strictObject({
+    personas: z.array(PersonaSchema),
+});
+/**
+ * PUT /v1/agents/{slug}/personas/{name}, the body: the caller, written whole. A name that exists
+ * is replaced; `was` renames the caller it names.
+ */
+export const PersonaPutSchema = z.strictObject({
+    about: z.string().nullish(),
+    goal: z.string(),
+    style: z.string(),
+    facts: z.record(z.string(), z.string()).nullish(),
+    state: z.record(z.string(), z.unknown()).nullish(),
+    was: z.string().nullish(),
+});

package/dist/generated/room.d.ts

@@ -23,9 +23,9 @@ export declare const ParticipantJoinedSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         agent: "agent";
         caller: "caller";
-        supervisor: "supervisor";
         listener: "listener";
         sip: "sip";
+        supervisor: "supervisor";
     }>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -51,15 +51,15 @@ export declare const TrackPublishedSchema: z.ZodObject<{
     identity: z.ZodString;
     kind: z.ZodEnum<{
         audio: "audio";
-        video: "video";
         screen: "screen";
+        video: "video";
     }>;
     source: z.ZodEnum<{
-        unknown: "unknown";
-        microphone: "microphone";
         camera: "camera";
+        microphone: "microphone";
         screen_share: "screen_share";
         screen_share_audio: "screen_share_audio";
+        unknown: "unknown";
     }>;
 }, z.core.$strict>;
 export type TrackPublished = z.infer<typeof TrackPublishedSchema>;
@@ -71,15 +71,15 @@ export declare const TrackUnpublishedSchema: z.ZodObject<{
     identity: z.ZodString;
     kind: z.ZodEnum<{
         audio: "audio";
-        video: "video";
         screen: "screen";
+        video: "video";
     }>;
     source: z.ZodEnum<{
-        unknown: "unknown";
-        microphone: "microphone";
         camera: "camera";
+        microphone: "microphone";
         screen_share: "screen_share";
         screen_share_audio: "screen_share_audio";
+        unknown: "unknown";
     }>;
 }, z.core.$strict>;
 export type TrackUnpublished = z.infer<typeof TrackUnpublishedSchema>;

package/dist/generated/state.d.ts

@@ -4,11 +4,11 @@ import { z } from "zod";
  * looks like.
  */
 export declare const CallStatusSchema: z.ZodEnum<{
-    idle: "idle";
-    ringing: "ringing";
-    dialing: "dialing";
     active: "active";
+    dialing: "dialing";
     ended: "ended";
+    idle: "idle";
+    ringing: "ringing";
 }>;
 export type CallStatus = z.infer<typeof CallStatusSchema>;
 /** One finished turn of the caller, with what the session measured about it. */
@@ -277,9 +277,9 @@ export declare const ToolRunSchema: z.ZodObject<{
     arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     speech_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     status: z.ZodEnum<{
-        running: "running";
         done: "done";
         failed: "failed";
+        running: "running";
     }>;
     output: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
     error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -312,9 +312,9 @@ export declare const ConfirmSchema: z.ZodObject<{
     audience: z.ZodString;
     phrase: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
-        granted: "granted";
         declined: "declined";
+        granted: "granted";
+        pending: "pending";
     }>;
     said: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -372,9 +372,9 @@ export declare const ParticipantSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         agent: "agent";
         caller: "caller";
-        supervisor: "supervisor";
         listener: "listener";
         sip: "sip";
+        supervisor: "supervisor";
     }>;
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     joined_at: z.ZodNumber;
@@ -391,9 +391,9 @@ export declare const RoomSchema: z.ZodObject<{
         kind: z.ZodEnum<{
             agent: "agent";
             caller: "caller";
-            supervisor: "supervisor";
             listener: "listener";
             sip: "sip";
+            supervisor: "supervisor";
         }>;
         name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         joined_at: z.ZodNumber;
@@ -430,11 +430,11 @@ export declare const StateSchema: z.ZodObject<{
     agent: z.ZodString;
     call: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
-        idle: "idle";
-        ringing: "ringing";
-        dialing: "dialing";
         active: "active";
+        dialing: "dialing";
         ended: "ended";
+        idle: "idle";
+        ringing: "ringing";
     }>;
     channel: z.ZodNullable<z.ZodEnum<{
         phone: "phone";
@@ -462,9 +462,9 @@ export declare const StateSchema: z.ZodObject<{
             kind: z.ZodEnum<{
                 agent: "agent";
                 caller: "caller";
-                supervisor: "supervisor";
                 listener: "listener";
                 sip: "sip";
+                supervisor: "supervisor";
             }>;
             name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             joined_at: z.ZodNumber;
@@ -476,29 +476,29 @@ export declare const StateSchema: z.ZodObject<{
     started_at: z.ZodNullable<z.ZodNumber>;
     ended_at: z.ZodNullable<z.ZodNumber>;
     end_reason: z.ZodNullable<z.ZodEnum<{
-        caller_hung_up: "caller_hung_up";
         agent_hung_up: "agent_hung_up";
-        supervisor_ended: "supervisor_ended";
-        transferred: "transferred";
-        no_answer: "no_answer";
+        app_detached: "app_detached";
         busy: "busy";
+        caller_hung_up: "caller_hung_up";
         dial_failed: "dial_failed";
-        timeout: "timeout";
         drained: "drained";
-        app_detached: "app_detached";
         error: "error";
+        no_answer: "no_answer";
+        supervisor_ended: "supervisor_ended";
+        timeout: "timeout";
+        transferred: "transferred";
     }>>;
     outcome: z.ZodNullable<z.ZodString>;
     user_state: z.ZodNullable<z.ZodEnum<{
+        away: "away";
         listening: "listening";
         speaking: "speaking";
-        away: "away";
     }>>;
     agent_state: z.ZodNullable<z.ZodEnum<{
+        idle: "idle";
+        initializing: "initializing";
         listening: "listening";
         speaking: "speaking";
-        initializing: "initializing";
-        idle: "idle";
         thinking: "thinking";
     }>>;
     live: z.ZodObject<{
@@ -714,9 +714,9 @@ export declare const StateSchema: z.ZodObject<{
         arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         speech_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         status: z.ZodEnum<{
-            running: "running";
             done: "done";
             failed: "failed";
+            running: "running";
         }>;
         output: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
         error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -746,18 +746,18 @@ export declare const StateSchema: z.ZodObject<{
         audience: z.ZodString;
         phrase: z.ZodString;
         status: z.ZodEnum<{
-            pending: "pending";
-            granted: "granted";
             declined: "declined";
+            granted: "granted";
+            pending: "pending";
         }>;
         said: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>;
     memory: z.ZodArray<z.ZodObject<{
         op: z.ZodEnum<{
+            forget: "forget";
             recall: "recall";
             remember: "remember";
-            forget: "forget";
         }>;
         contact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         query: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -857,12 +857,12 @@ export declare const StateSchema: z.ZodObject<{
             provider: z.ZodString;
             model: z.ZodString;
             unit: z.ZodEnum<{
-                input_tokens: "input_tokens";
-                cached_input_tokens: "cached_input_tokens";
+                audio_seconds: "audio_seconds";
                 cache_creation_tokens: "cache_creation_tokens";
-                output_tokens: "output_tokens";
+                cached_input_tokens: "cached_input_tokens";
                 characters: "characters";
-                audio_seconds: "audio_seconds";
+                input_tokens: "input_tokens";
+                output_tokens: "output_tokens";
                 requests: "requests";
                 session_seconds: "session_seconds";
             }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinecall/protocol",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "The Pinecall wire: zod schemas and types generated from the protocol schema, and the log reducer",
   "license": "Apache-2.0",
   "author": "Pinecall <hello@pinecall.io>",