@pinecall/protocol 0.5.0 → 0.6.1

package/dist/generated/rest.d.ts

@@ -6,11 +6,11 @@ export declare const CallStateSchema: 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";
@@ -38,9 +38,9 @@ export declare const CallStateSchema: 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;
@@ -52,29 +52,29 @@ export declare const CallStateSchema: 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<{
@@ -290,9 +290,9 @@ export declare const CallStateSchema: 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>>;
@@ -322,18 +322,18 @@ export declare const CallStateSchema: 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>>;
@@ -433,12 +433,12 @@ export declare const CallStateSchema: 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";
                 }>;
@@ -511,9 +511,9 @@ export type SessionScore = z.infer<typeof SessionScoreSchema>;
  * committing the business to something no tool call records.
  */
 export declare const SessionFlagSchema: z.ZodEnum<{
-    promise: "promise";
     escalated: "escalated";
     low_score: "low_score";
+    promise: "promise";
 }>;
 export type SessionFlag = z.infer<typeof SessionFlagSchema>;
 /** One call as a list draws it: which call, how far the log got, and the state's own fields. */
@@ -523,11 +523,11 @@ export declare const SessionLineSchema: z.ZodObject<{
     live: z.ZodBoolean;
     last_seq: z.ZodInt;
     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";
@@ -550,17 +550,17 @@ export declare const SessionLineSchema: 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>;
     cost: z.ZodNullable<z.ZodObject<{
@@ -574,12 +574,12 @@ export declare const SessionLineSchema: 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";
             }>;
@@ -599,9 +599,9 @@ export declare const SessionLineSchema: z.ZodObject<{
         reason: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>>>;
     flags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
-        promise: "promise";
         escalated: "escalated";
         low_score: "low_score";
+        promise: "promise";
     }>>>>;
 }, z.core.$strict>;
 export type SessionLine = z.infer<typeof SessionLineSchema>;
@@ -616,11 +616,11 @@ export declare const SessionListSchema: z.ZodObject<{
         live: z.ZodBoolean;
         last_seq: z.ZodInt;
         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";
@@ -643,17 +643,17 @@ export declare const SessionListSchema: 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>;
         cost: z.ZodNullable<z.ZodObject<{
@@ -667,12 +667,12 @@ export declare const SessionListSchema: 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";
                 }>;
@@ -692,9 +692,9 @@ export declare const SessionListSchema: z.ZodObject<{
             reason: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>>>>;
         flags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodEnum<{
-            promise: "promise";
             escalated: "escalated";
             low_score: "low_score";
+            promise: "promise";
         }>>>>;
     }, z.core.$strict>>;
     total: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodInt>>>;
@@ -779,8 +779,8 @@ export type JudgingWanted = z.infer<typeof JudgingWantedSchema>;
  */
 export declare const ThreadKindSchema: z.ZodEnum<{
     call: "call";
-    out: "out";
     in: "in";
+    out: "out";
 }>;
 export type ThreadKind = z.infer<typeof ThreadKindSchema>;
 /** The newest thing on a contact's thread. */
@@ -789,8 +789,8 @@ export declare const ThreadLastSchema: z.ZodObject<{
     at: z.ZodNumber;
     kind: z.ZodEnum<{
         call: "call";
-        out: "out";
         in: "in";
+        out: "out";
     }>;
 }, z.core.$strict>;
 export type ThreadLast = z.infer<typeof ThreadLastSchema>;
@@ -808,8 +808,8 @@ export declare const ThreadLineSchema: z.ZodObject<{
         at: z.ZodNumber;
         kind: z.ZodEnum<{
             call: "call";
-            out: "out";
             in: "in";
+            out: "out";
         }>;
     }, z.core.$strict>;
     unread: z.ZodInt;
@@ -831,8 +831,8 @@ export declare const ThreadListSchema: z.ZodObject<{
             at: z.ZodNumber;
             kind: z.ZodEnum<{
                 call: "call";
-                out: "out";
                 in: "in";
+                out: "out";
             }>;
         }, z.core.$strict>;
         unread: z.ZodInt;
@@ -845,8 +845,8 @@ export type ThreadList = z.infer<typeof ThreadListSchema>;
 export declare const ThreadMessageSchema: z.ZodObject<{
     kind: z.ZodEnum<{
         call: "call";
-        out: "out";
         in: "in";
+        out: "out";
     }>;
     text: z.ZodNullable<z.ZodString>;
     at: z.ZodNumber;
@@ -867,8 +867,8 @@ export declare const ThreadSchema: z.ZodObject<{
     messages: z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<{
             call: "call";
-            out: "out";
             in: "in";
+            out: "out";
         }>;
         text: z.ZodNullable<z.ZodString>;
         at: z.ZodNumber;
@@ -982,9 +982,9 @@ export declare const OrgMailWantedSchema: z.ZodObject<{
     host: z.ZodString;
     port: z.ZodInt;
     security: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        none: "none";
         starttls: "starttls";
         tls: "tls";
-        none: "none";
     }>>>;
     username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     password: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1212,10 +1212,6 @@ export declare const KnowledgePushSchema: z.ZodObject<{
     files: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         text: z.ZodString;
-        mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            retrieved: "retrieved";
-            whole: "whole";
-        }>>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type KnowledgePush = z.infer<typeof KnowledgePushSchema>;
@@ -1269,15 +1265,13 @@ export declare const KnowledgeScoreSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type KnowledgeScore = z.infer<typeof KnowledgeScoreSchema>;
 /**
- * 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 declare const KnowledgePushedSchema: z.ZodObject<{
     base: z.ZodString;
     chunks: z.ZodInt;
     took_ms: z.ZodNumber;
-    whole_tokens: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
-    notice: z.ZodOptional<z.ZodNullable<z.ZodNullable<z.ZodString>>>;
 }, z.core.$strict>;
 export type KnowledgePushed = z.infer<typeof KnowledgePushedSchema>;
 /** One knowledge base as the list draws it: its name, its size, and when it was last pushed. */
@@ -1598,9 +1592,8 @@ export declare const OutboundProvisionedSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type OutboundProvisioned = z.infer<typeof OutboundProvisionedSchema>;
 /**
- * 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 declare const TuningBodySchema: z.ZodObject<{
     voice: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1624,7 +1617,8 @@ export declare const TuningBodySchema: z.ZodObject<{
         remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
         forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     }, z.core.$strict>>>;
-    knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+    knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         base: z.ZodString;
         mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             retrieved: "retrieved";
@@ -1667,7 +1661,8 @@ export declare const TuningRowSchema: z.ZodObject<{
             remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
         }, z.core.$strict>>>;
-        knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
             base: z.ZodString;
             mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 retrieved: "retrieved";
@@ -1716,7 +1711,8 @@ export declare const TuningAnswerSchema: z.ZodObject<{
                 remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
                 forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             }, z.core.$strict>>>;
-            knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 base: z.ZodString;
                 mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     retrieved: "retrieved";
@@ -1755,7 +1751,8 @@ export declare const TuningAnswerSchema: z.ZodObject<{
                 remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
                 forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             }, z.core.$strict>>>;
-            knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 base: z.ZodString;
                 mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     retrieved: "retrieved";
@@ -1794,7 +1791,8 @@ export declare const TuningAnswerSchema: z.ZodObject<{
                 remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
                 forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             }, z.core.$strict>>>;
-            knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 base: z.ZodString;
                 mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     retrieved: "retrieved";
@@ -1834,7 +1832,8 @@ export declare const TuningPutSchema: z.ZodObject<{
             remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
         }, z.core.$strict>>>;
-        knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
             base: z.ZodString;
             mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 retrieved: "retrieved";
@@ -1884,7 +1883,8 @@ export declare const TuningHistorySchema: z.ZodObject<{
                 remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
                 forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             }, z.core.$strict>>>;
-            knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 base: z.ZodString;
                 mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     retrieved: "retrieved";
@@ -1930,7 +1930,8 @@ export declare const TuningDiffSchema: z.ZodObject<{
                 remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
                 forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             }, z.core.$strict>>>;
-            knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 base: z.ZodString;
                 mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     retrieved: "retrieved";
@@ -1969,7 +1970,8 @@ export declare const TuningDiffSchema: z.ZodObject<{
                 remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
                 forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             }, z.core.$strict>>>;
-            knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 base: z.ZodString;
                 mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     retrieved: "retrieved";
@@ -2145,7 +2147,8 @@ export declare const CallTuningSchema: z.ZodObject<{
                 remember: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
                 forget: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
             }, z.core.$strict>>>;
-            knowledge: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+            knowledge: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            bases: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
                 base: z.ZodString;
                 mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     retrieved: "retrieved";
@@ -2172,6 +2175,56 @@ export declare const CallTuningSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type CallTuning = z.infer<typeof CallTuningSchema>;
+/** One file of a base as the list draws it. */
+export declare const KnowledgeFileRowSchema: z.ZodObject<{
+    path: z.ZodString;
+    chars: z.ZodInt;
+    chunks: z.ZodInt;
+    pushed_at: z.ZodNumber;
+}, z.core.$strict>;
+export type KnowledgeFileRow = z.infer<typeof KnowledgeFileRowSchema>;
+/**
+ * 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 declare const KnowledgeFilesSchema: z.ZodObject<{
+    base: z.ZodString;
+    kept: z.ZodBoolean;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        chars: z.ZodInt;
+        chunks: z.ZodInt;
+        pushed_at: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeFiles = z.infer<typeof KnowledgeFilesSchema>;
+/** GET /v1/knowledge/{base}/files/{path}: one file, text and all. */
+export declare const KnowledgeFileReadSchema: z.ZodObject<{
+    path: z.ZodString;
+    text: z.ZodString;
+    chunks: z.ZodInt;
+    pushed_at: z.ZodNumber;
+}, z.core.$strict>;
+export type KnowledgeFileRead = z.infer<typeof KnowledgeFileReadSchema>;
+/**
+ * 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 declare const KnowledgeFilePutSchema: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strict>;
+export type KnowledgeFilePut = z.infer<typeof KnowledgeFilePutSchema>;
+/**
+ * PUT /v1/knowledge/{base}/files/{path}, the answer: which file, how many chunks it became, and
+ * how long that took.
+ */
+export declare const KnowledgeFilePushedSchema: z.ZodObject<{
+    base: z.ZodString;
+    path: z.ZodString;
+    chunks: z.ZodInt;
+    took_ms: z.ZodNumber;
+}, z.core.$strict>;
+export type KnowledgeFilePushed = z.infer<typeof KnowledgeFilePushedSchema>;
 /** One base and the agents whose settings attach it. */
 export declare const KnowledgeUseSchema: z.ZodObject<{
     base: z.ZodString;
@@ -2189,3 +2242,46 @@ export declare const KnowledgeUsesSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type KnowledgeUses = z.infer<typeof KnowledgeUsesSchema>;
+/**
+ * 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 declare const PersonaSchema: z.ZodObject<{
+    name: z.ZodString;
+    about: z.ZodString;
+    goal: z.ZodString;
+    style: z.ZodString;
+    facts: z.ZodRecord<z.ZodString, z.ZodString>;
+    state: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    author: z.ZodString;
+    set_at: z.ZodNumber;
+}, z.core.$strict>;
+export type Persona = z.infer<typeof PersonaSchema>;
+/** GET /v1/agents/{slug}/personas: every caller written for this agent, by name. */
+export declare const PersonaListSchema: z.ZodObject<{
+    personas: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        about: z.ZodString;
+        goal: z.ZodString;
+        style: z.ZodString;
+        facts: z.ZodRecord<z.ZodString, z.ZodString>;
+        state: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        author: z.ZodString;
+        set_at: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type PersonaList = z.infer<typeof PersonaListSchema>;
+/**
+ * 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 declare const PersonaPutSchema: z.ZodObject<{
+    about: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    goal: z.ZodString;
+    style: z.ZodString;
+    facts: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    state: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    was: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type PersonaPut = z.infer<typeof PersonaPutSchema>;