@pinecall/agents 0.9.20

package/dist/wire/defs.js

@@ -0,0 +1,212 @@
+/** The shapes the rest of the wire is made of: channels, parts of a turn, tools, memory, costs. */
+import { z } from "zod";
+/**
+ * The door the public came through: a phone call over SIP, the browser widget over WebRTC, or
+ * WhatsApp text.
+ */
+export const ChannelSchema = z.enum(["phone", "web", "whatsapp"]);
+/** How a call is had: spoken (`voice`) or written (`text`). A web call can be either. */
+export const MediumSchema = z.enum(["voice", "text"]);
+/** Inbound: the public reached the agent. Outbound: the agent reached out (a dial). */
+export const DirectionSchema = z.enum(["inbound", "outbound"]);
+/**
+ * Which of the two worlds a key opens, and so which world an agent is held in and a call ran in. A
+ * key is issued into one; an agent registered on it and every call it takes carry that one; a door
+ * claimed in one is refused to a key of the other. `sandbox` is where things are written and
+ * `production` is what the public reaches — and whether a sandbox agent is one PERSON's copy or
+ * the team's shared one is not this field: it is whether the key that registered it names a
+ * person. Every key issued before the field existed is production.
+ */
+export const EnvSchema = z.enum(["production", "sandbox"]);
+/**
+ * What a console may ask of the process standing in the agent's directory, relayed by the gateway:
+ * a written call to the class mounted there (chat), a simulated caller put on the class it holds,
+ * its goldens and a suite of them, its knowledge folder pushed or its golden asked, its memory
+ * goldens, the panel it draws beside a conversation (view), a call promoted to a candidate file,
+ * the drift of the last two windows, and the reproductions a broken run left on that disk.
+ * Everything else a console needs is a door of the gateway.
+ */
+export const DevVerbSchema = z.enum(["chat.roster", "chat.start", "chat.say", "chat.end", "view.render", "simulate.start", "goldens.roster", "goldens.run", "knowledge.roster", "knowledge.push", "knowledge.eval", "memory.roster", "memory.eval", "memory.extraction", "promote.roster", "promote.write", "drift.read", "reproductions.roster", "reproductions.read"]);
+/**
+ * Why the call is over. Who hung up, what failed before anybody could, drained: the platform took
+ * the worker down (a deploy, a stop) with the call still on it, or app_detached: the app holding
+ * the agent closed its socket mid-call, so nothing was rendering the prompt or answering a tool —
+ * both are nobody's fault and neither is an error.
+ */
+export const EndReasonSchema = z.enum(["caller_hung_up", "agent_hung_up", "supervisor_ended", "transferred", "no_answer", "busy", "dial_failed", "timeout", "drained", "app_detached", "error"]);
+/** Whose action ended the call. platform covers timeouts, errors and a drained worker. */
+export const EndedBySchema = z.enum(["caller", "agent", "supervisor", "platform"]);
+/**
+ * What one judge answered about a finished call. Held: the rule held. Broken: it did not, and the
+ * reason names the evidence. Deferred: the judge was asked and could not settle it. Skipped:
+ * nobody asked it — no model was reachable inside the call's judging budget.
+ */
+export const ScoreVerdictSchema = z.enum(["held", "broken", "deferred", "skipped"]);
+/**
+ * Cold: the caller is sent on with a REFER on their SIP leg and the call ends here. Warm: the
+ * number is dialled into the call's own room, the agent stays on the line until the other side
+ * answers and then falls silent; the call ends when either of them hangs up.
+ */
+export const TransferModeSchema = z.enum(["cold", "warm"]);
+/**
+ * Which region of the prompt a block lives in: static, before the history, cached by the provider;
+ * or dynamic, after the history, replaced every turn. The append-only history in between is never
+ * written by the app.
+ */
+export const PromptRegionSchema = z.enum(["static", "dynamic"]);
+/**
+ * How the knowledge base reaches the model: retrieved, the platform runs search itself when the
+ * caller's turn ends; or tool, the model calls search when it decides to. Either way the chunks
+ * arrive as a tool result.
+ */
+export const DocsModeSchema = z.enum(["retrieved", "tool"]);
+/**
+ * One named block of the prompt and the region it lives in. The default layout, when an agent
+ * declares none, is identity, knowledge and tools (static), then the history, then view (dynamic).
+ * A block's text is written per call with prompt.set.
+ */
+export const PromptBlockSpecSchema = z.strictObject({
+    name: z.string().regex(/^[a-z][a-z0-9_]*$/),
+    region: PromptRegionSchema,
+});
+/**
+ * What the platform believes the person on the line is doing right now. The states are the
+ * session's own.
+ */
+export const UserStateSchema = z.enum(["listening", "speaking", "away"]);
+/**
+ * What the agent is doing right now, in the session's own words: warming up, waiting, hearing the
+ * caller, generating, or playing audio.
+ */
+export const AgentStateSchema = z.enum(["initializing", "idle", "listening", "thinking", "speaking"]);
+/**
+ * Who a participant is to the call: the person the agent serves (over SIP or the widget), the
+ * agent itself, a supervisor who took a seat in the room, a listener who only hears, or a second
+ * SIP leg that room.invite brought in.
+ */
+export const ParticipantKindSchema = z.enum(["caller", "agent", "supervisor", "listener", "sip"]);
+/** What a track carries: a microphone's audio, a camera's video, or a screen share. */
+export const TrackKindSchema = z.enum(["audio", "video", "screen"]);
+/** Where a track comes from, as livekit's TrackSource names it, in lower case. */
+export const TrackSourceSchema = z.enum(["microphone", "camera", "screen_share", "screen_share_audio", "unknown"]);
+/**
+ * Where an outside fact came from: the tenant's backend over the app socket (app), or a
+ * participant's browser over the DataChannel (participant).
+ */
+export const EventSourceSchema = z.enum(["app", "participant"]);
+/**
+ * Who may see a field of the app's state: everyone in the call (public), the tenant's own readers
+ * (tenant, the default for a field never declared), or nobody without masking (pii).
+ */
+export const VisibilitySchema = z.enum(["public", "tenant", "pii"]);
+/**
+ * Which projection a sink applies before a state or an entry leaves the platform: public for a
+ * participant reading its own call, tenant for the tenant's readers. The contract is
+ * docs/protocol/projections.md; a client never applies one.
+ */
+export const ProjectionSchema = z.enum(["public", "tenant"]);
+/**
+ * Who is on the line, as far as the platform knows. Everything is optional: a web visitor may be
+ * nobody yet.
+ */
+export const ContactSchema = z.strictObject({
+    id: z.string().nullish(),
+    phone: z.string().nullish(),
+    name: z.string().nullish(),
+    email: z.string().nullish(),
+    external_id: z.string().nullish(),
+});
+/**
+ * One door to an agent: a channel and, for phone and WhatsApp, the number that answers. A number
+ * is a route, never an agent.
+ */
+export const RouteSchema = z.strictObject({
+    channel: ChannelSchema,
+    number: z.string().nullable(),
+    label: z.string().nullish(),
+});
+/** The human who sent a supervise verb, as the token that let them in names them. */
+export const SupervisorSchema = z.strictObject({
+    id: z.string(),
+    name: z.string().nullish(),
+});
+/**
+ * What the app declares about one tool: the contract the model sees and the rules the platform
+ * enforces before running it.
+ */
+export const ToolSpecSchema = z.strictObject({
+    name: z.string(),
+    description: z.string(),
+    parameters: z.record(z.string(), z.unknown()),
+    side_effect: z.enum(["read", "write", "irreversible"]).nullish(),
+    confirm: z.string().nullish(),
+    pii: z.array(z.string()).nullish(),
+    timeout_s: z.number().nullish(),
+});
+/**
+ * What came back from running a tool in the app's process. Either an output or an error, never
+ * both.
+ */
+export const ToolResultSchema = z.strictObject({
+    call_id: z.string(),
+    name: z.string(),
+    output: z.unknown().nullish(),
+    error: z.string().nullish(),
+    summary: z.string().nullish(),
+    duration_s: z.number().nullish(),
+});
+/**
+ * One thing remembered about a contact: a sentence, where it came from, and how well it matched
+ * when recalled.
+ */
+export const MemoryFactSchema = z.strictObject({
+    id: z.string().nullish(),
+    text: z.string(),
+    category: z.string().nullish(),
+    score: z.number().nullish(),
+    source: z.string().nullish(),
+});
+/**
+ * One operation against the contact's memory: a recall during the turn, a remember at hangup, or a
+ * forget on request.
+ */
+export const MemoryOpSchema = z.strictObject({
+    op: z.enum(["recall", "remember", "forget"]),
+    contact: z.string().nullish(),
+    query: z.string().nullish(),
+    facts: z.array(MemoryFactSchema),
+    took_ms: z.number(),
+});
+/** One chunk of the knowledge base that retrieval put in front of the model for this turn. */
+export const DocSourceSchema = z.strictObject({
+    id: z.string(),
+    base: z.string().nullish(),
+    path: z.string(),
+    heading: z.string().nullish(),
+    score: z.number(),
+    excerpt: z.string().nullish(),
+});
+/** One priced line: a model, what was counted, how much, and what it came to. */
+export const CostRowSchema = z.strictObject({
+    provider: z.string(),
+    model: z.string(),
+    unit: z.enum(["input_tokens", "cached_input_tokens", "cache_creation_tokens", "output_tokens", "characters", "audio_seconds", "requests", "session_seconds", "minutes"]),
+    quantity: z.number(),
+    unit_price_usd: z.number(),
+    usd: z.number(),
+});
+/** A usage row the price table does not know. It is listed, never priced at zero. */
+export const UnpricedRowSchema = z.strictObject({
+    provider: z.string(),
+    model: z.string(),
+});
+/**
+ * What the call cost in provider fees, informational, in US dollars, the currency providers price
+ * in. The runtime never prices commercially; this is the provider's bill as best we know it.
+ */
+export const CostSchema = z.strictObject({
+    usd: z.number(),
+    rows: z.array(CostRowSchema),
+    unpriced: z.array(UnpricedRowSchema),
+});
+//# sourceMappingURL=defs.js.map

package/dist/wire/defs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.js","sourceRoot":"","sources":["../../src/wire/defs.ts"],"names":[],"mappings":"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"}

package/dist/wire/envelope.d.ts

@@ -0,0 +1,29 @@
+/** The log entry and the command frame, as the socket and every door carry them. */
+import { z } from "zod";
+/**
+ * One line of a call's log, or of an agent's log when call is null. seq is written before control
+ * returns, so two readers never disagree about order.
+ */
+export declare const EntrySchema: z.ZodObject<{
+    seq: z.ZodInt;
+    ts: z.ZodNumber;
+    call: z.ZodNullable<z.ZodString>;
+    agent: z.ZodString;
+    type: z.ZodString;
+    ephemeral: z.ZodBoolean;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type Entry = z.infer<typeof EntrySchema>;
+/**
+ * One instruction from an app to the gateway over its WebSocket. The gateway answers with the
+ * events the command produces, or with an error naming the command's id.
+ */
+export declare const CommandSchema: z.ZodObject<{
+    type: z.ZodString;
+    agent: z.ZodString;
+    call: z.ZodNullable<z.ZodString>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strict>;
+export type Command = z.infer<typeof CommandSchema>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/wire/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/wire/envelope.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;kBAQtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;kBAMxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/wire/envelope.js

@@ -0,0 +1,27 @@
+/** The log entry and the command frame, as the socket and every door carry them. */
+import { z } from "zod";
+/**
+ * One line of a call's log, or of an agent's log when call is null. seq is written before control
+ * returns, so two readers never disagree about order.
+ */
+export const EntrySchema = z.strictObject({
+    seq: z.int(),
+    ts: z.number(),
+    call: z.string().nullable(),
+    agent: z.string(),
+    type: z.string(),
+    ephemeral: z.boolean(),
+    data: z.record(z.string(), z.unknown()),
+});
+/**
+ * One instruction from an app to the gateway over its WebSocket. The gateway answers with the
+ * events the command produces, or with an error naming the command's id.
+ */
+export const CommandSchema = z.strictObject({
+    type: z.string(),
+    agent: z.string(),
+    call: z.string().nullable(),
+    id: z.string().nullish(),
+    data: z.record(z.string(), z.unknown()),
+});
+//# sourceMappingURL=envelope.js.map

package/dist/wire/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/wire/envelope.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE;IACZ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CACxC,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CACxC,CAAC,CAAC"}