@pinecall/protocol 0.4.0 → 0.6.0

package/dist/generated/commands.d.ts

@@ -46,10 +46,6 @@ export declare const AgentConfigureSchema: z.ZodObject<{
         knowledge: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             path: z.ZodString;
             text: z.ZodString;
-            mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                retrieved: "retrieved";
-                whole: "whole";
-            }>>>;
         }, z.core.$strict>>>;
         docs: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             base: z.ZodString;
@@ -114,6 +110,7 @@ export declare const AgentRegisterSchema: z.ZodObject<{
         label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>;
     sdk: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     takes_unclaimed: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
 }, z.core.$strict>;
 export type AgentRegister = z.infer<typeof AgentRegisterSchema>;
@@ -323,10 +320,6 @@ export declare const SessionConfigureSchema: z.ZodObject<{
         knowledge: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             path: z.ZodString;
             text: z.ZodString;
-            mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                retrieved: "retrieved";
-                whole: "whole";
-            }>>>;
         }, z.core.$strict>>>;
         docs: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             base: z.ZodString;

package/dist/generated/commands.js

@@ -16,6 +16,7 @@ export const AgentConfigureSchema = z.strictObject({
 export const AgentRegisterSchema = z.strictObject({
     routes: z.array(RouteSchema),
     sdk: z.string().nullish(),
+    host: z.string().nullish(),
     takes_unclaimed: z.boolean().nullish(),
 });
 /**

package/dist/generated/defs.d.ts

@@ -455,14 +455,10 @@ export declare const EventSpecSchema: z.ZodObject<{
     }>>;
 }, z.core.$strict>;
 export type EventSpec = z.infer<typeof EventSpecSchema>;
-/** One file of knowledge, sent whole: its path as the tenant keeps it, and its text. */
+/** One file of a base, as a push sends it: its path as the tenant keeps it, and its text. */
 export declare const KnowledgeFileSchema: z.ZodObject<{
     path: z.ZodString;
     text: z.ZodString;
-    mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        retrieved: "retrieved";
-        whole: "whole";
-    }>>>;
 }, z.core.$strict>;
 export type KnowledgeFile = z.infer<typeof KnowledgeFileSchema>;
 /**
@@ -513,9 +509,11 @@ export declare const MemoryConfigSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type MemoryConfig = z.infer<typeof MemoryConfigSchema>;
 /**
- * What an app declares about its agent: the voice, the models, the language, the greeting, the
- * tools, and who may see and send what. Every field is optional so a configure can change one
- * thing.
+ * What an app declares about its agent: the prompt's layout, the language, the tools, whether it
+ * searches its bases itself, and who may see and send what. Every field is optional so a configure
+ * can change one thing. The environment — voice, models, greeting, hangup, turn, says, hears,
+ * knowledge, docs, memory — is the world's, set in the agent's settings, and no longer read off
+ * this declaration.
  */
 export declare const AgentConfigSchema: z.ZodObject<{
     prompt: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
@@ -559,10 +557,6 @@ export declare const AgentConfigSchema: z.ZodObject<{
     knowledge: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         path: z.ZodString;
         text: z.ZodString;
-        mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            retrieved: "retrieved";
-            whole: "whole";
-        }>>>;
     }, z.core.$strict>>>;
     docs: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         base: z.ZodString;

package/dist/generated/defs.js

@@ -258,11 +258,10 @@ export const EventSpecSchema = z.strictObject({
     name: z.string(),
     from: z.array(EventSourceSchema),
 });
-/** One file of knowledge, sent whole: its path as the tenant keeps it, and its text. */
+/** One file of a base, as a push sends it: its path as the tenant keeps it, and its text. */
 export const KnowledgeFileSchema = z.strictObject({
     path: z.string(),
     text: z.string(),
-    mode: z.enum(["retrieved", "whole"]).nullish(),
 });
 /**
  * The knowledge base the agent answers from, and how its chunks reach the model. It is named by
@@ -305,9 +304,11 @@ export const MemoryConfigSchema = z.strictObject({
     forget: z.array(z.string()).nullish(),
 });
 /**
- * What an app declares about its agent: the voice, the models, the language, the greeting, the
- * tools, and who may see and send what. Every field is optional so a configure can change one
- * thing.
+ * What an app declares about its agent: the prompt's layout, the language, the tools, whether it
+ * searches its bases itself, and who may see and send what. Every field is optional so a configure
+ * can change one thing. The environment — voice, models, greeting, hangup, turn, says, hears,
+ * knowledge, docs, memory — is the world's, set in the agent's settings, and no longer read off
+ * this declaration.
  */
 export const AgentConfigSchema = z.strictObject({
     prompt: z.array(PromptBlockSpecSchema).nullish(),

package/dist/generated/registry.d.ts

@@ -1305,10 +1305,6 @@ export declare const COMMAND_SCHEMAS: {
             knowledge: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
                 path: import("zod").ZodString;
                 text: import("zod").ZodString;
-                mode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodEnum<{
-                    retrieved: "retrieved";
-                    whole: "whole";
-                }>>>;
             }, import("zod/v4/core").$strict>>>;
             docs: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
                 base: import("zod").ZodString;
@@ -1368,6 +1364,7 @@ export declare const COMMAND_SCHEMAS: {
             label: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         }, import("zod/v4/core").$strict>>;
         sdk: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+        host: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
         takes_unclaimed: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodBoolean>>;
     }, import("zod/v4/core").$strict>;
     readonly "agent.reply": import("zod").ZodObject<{
@@ -1490,10 +1487,6 @@ export declare const COMMAND_SCHEMAS: {
             knowledge: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
                 path: import("zod").ZodString;
                 text: import("zod").ZodString;
-                mode: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodEnum<{
-                    retrieved: "retrieved";
-                    whole: "whole";
-                }>>>;
             }, import("zod/v4/core").$strict>>>;
             docs: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
                 base: import("zod").ZodString;

package/dist/generated/rest.d.ts

@@ -1128,6 +1128,59 @@ export declare const AgentListSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type AgentList = z.infer<typeof AgentListSchema>;
+/**
+ * One app connected to the gateway right now: one process on one machine, holding one or more
+ * agents in one world.
+ */
+export declare const AppProcessSchema: z.ZodObject<{
+    app: z.ZodString;
+    agents: z.ZodArray<z.ZodString>;
+    env: z.ZodEnum<{
+        production: "production";
+        sandbox: "sandbox";
+    }>;
+    host: z.ZodNullable<z.ZodString>;
+    address: z.ZodNullable<z.ZodString>;
+    sdk: z.ZodNullable<z.ZodString>;
+    holder: z.ZodNullable<z.ZodObject<{
+        holder: z.ZodNullable<z.ZodString>;
+        name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    connected_at: z.ZodNumber;
+}, z.core.$strict>;
+export type AppProcess = z.infer<typeof AppProcessSchema>;
+/**
+ * GET /v1/apps: every app connected in the request's world that this key may see — its own
+ * corner's and the org's, every corner's with `team`.
+ */
+export declare const AppListSchema: z.ZodObject<{
+    apps: z.ZodArray<z.ZodObject<{
+        app: z.ZodString;
+        agents: z.ZodArray<z.ZodString>;
+        env: z.ZodEnum<{
+            production: "production";
+            sandbox: "sandbox";
+        }>;
+        host: z.ZodNullable<z.ZodString>;
+        address: z.ZodNullable<z.ZodString>;
+        sdk: z.ZodNullable<z.ZodString>;
+        holder: z.ZodNullable<z.ZodObject<{
+            holder: z.ZodNullable<z.ZodString>;
+            name: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        connected_at: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AppList = z.infer<typeof AppListSchema>;
+/**
+ * POST /v1/apps/{app}/stop, the answer: the socket was closed with the stop code, and the app
+ * exits rather than reconnect.
+ */
+export declare const AppStoppedSchema: z.ZodObject<{
+    app: z.ZodString;
+    stopped: z.ZodBoolean;
+}, z.core.$strict>;
+export type AppStopped = z.infer<typeof AppStoppedSchema>;
 /**
  * GET /v1/agents/{slug}/line: whose terminal a call that RINGS at this agent's doors lands in. An
  * org shares one sandbox number, so it rings in one place and which one is claimed.
@@ -1159,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>;
@@ -1216,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. */
@@ -1545,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>>;
@@ -1571,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";
@@ -1614,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";
@@ -1663,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";
@@ -1702,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";
@@ -1741,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";
@@ -1781,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";
@@ -1831,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";
@@ -1877,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";
@@ -1916,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";
@@ -2092,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";

package/dist/generated/rest.js

@@ -340,6 +340,35 @@ export const HeldAgentSchema = z.strictObject({
 export const AgentListSchema = z.strictObject({
     agents: z.array(HeldAgentSchema),
 });
+/**
+ * One app connected to the gateway right now: one process on one machine, holding one or more
+ * agents in one world.
+ */
+export const AppProcessSchema = z.strictObject({
+    app: z.string(),
+    agents: z.array(z.string()),
+    env: EnvSchema,
+    host: z.string().nullable(),
+    address: z.string().nullable(),
+    sdk: z.string().nullable(),
+    holder: LineHolderSchema.nullable(),
+    connected_at: z.number(),
+});
+/**
+ * GET /v1/apps: every app connected in the request's world that this key may see — its own
+ * corner's and the org's, every corner's with `team`.
+ */
+export const AppListSchema = z.strictObject({
+    apps: z.array(AppProcessSchema),
+});
+/**
+ * POST /v1/apps/{app}/stop, the answer: the socket was closed with the stop code, and the app
+ * exits rather than reconnect.
+ */
+export const AppStoppedSchema = z.strictObject({
+    app: z.string(),
+    stopped: z.boolean(),
+});
 /**
  * GET /v1/agents/{slug}/line: whose terminal a call that RINGS at this agent's doors lands in. An
  * org shares one sandbox number, so it rings in one place and which one is claimed.
@@ -399,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({
@@ -631,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(),
@@ -645,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinecall/protocol",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "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>",