@pinecall/agents 0.9.20

package/dist/wire/commands.js

@@ -0,0 +1,203 @@
+/** The commands an app sends a call, one schema each. */
+import { z } from "zod";
+import { AgentConfigSchema } from "./agent-config.js";
+import { ContactSchema, RouteSchema, SupervisorSchema, ToolSpecSchema, TransferModeSchema, } from "./defs.js";
+import { VerbSchema } from "./verbs.js";
+/**
+ * Declare or change what the agent is: voice, models, greeting, the full tool list. Only
+ * the fields sent change.
+ */
+export const AgentConfigureSchema = z.strictObject({
+    config: AgentConfigSchema,
+});
+/** This socket is leaving, and its calls go on without it. */
+export const AgentDrainSchema = z.strictObject({});
+/**
+ * The app's first message: this socket speaks for this agent and answers these doors. The gateway
+ * answers agent.registered, or error.
+ */
+export const AgentRegisterSchema = z.strictObject({
+    routes: z.array(RouteSchema),
+    sdk: z.string().nullish(),
+    host: z.string().nullish(),
+    takes_unclaimed: z.boolean().nullish(),
+    /** This socket answers the console's dev verbs for the agent; `view.render` still goes to the one serving the call. */
+    answers_dev: z.boolean().nullish(),
+});
+/**
+ * Make the model speak now, guided by an instruction it reads and the caller never hears: 'tell
+ * them a slot at 10:15 just opened'. On livekit's session.generate_reply; the sibling of
+ * agent.say, which speaks verbatim. The reply lands as turn.agent.
+ */
+export const AgentReplySchema = z.strictObject({
+    instructions: z.string(),
+    allow_interruptions: z.boolean().nullish(),
+});
+/**
+ * Make the agent say this text now, verbatim, outside the model's turn: a greeting, a read-back, a
+ * system notice. The reply lands as turn.agent.
+ */
+export const AgentSaySchema = z.strictObject({
+    text: z.string(),
+    allow_interruptions: z.boolean().nullish(),
+});
+/**
+ * Ask for a person without sending the caller anywhere: the call waits on hold until a supervisor
+ * takes the line, or until wait_s passes with nobody taking it. attention.answered says which.
+ */
+export const CallAttentionSchema = z.strictObject({
+    reason: z.string(),
+    wait_s: z.number(),
+});
+/**
+ * Write down that the caller wants to be called back. Lands as callback.requested with via agent;
+ * placing the call is the app's.
+ */
+export const CallCallbackSchema = z.strictObject({
+    number: z.string(),
+    when: z.string().nullish(),
+    note: z.string().nullish(),
+});
+/** The caller asked never to be called again: their number joins the org's do-not-call list. */
+export const CallOptOutSchema = z.strictObject({
+    note: z.string().max(500).nullish(),
+});
+/** The code the caller said, to bind this call to the page that shows it. */
+export const CallClaimSchema = z.strictObject({
+    code: z.string().regex(/^[0-9]{4}$/),
+});
+/**
+ * Place an outbound call as this agent. The new call's log opens with call.dialing; call.started
+ * follows when the far end answers.
+ */
+export const CallDialSchema = z.strictObject({
+    to: z.string(),
+    from: z.string().nullish(),
+    caller: ContactSchema.nullish(),
+    metadata: z.record(z.string(), z.unknown()).nullish(),
+});
+/** Send touch tones down the line, for an IVR on the far end. */
+export const CallDtmfSchema = z.strictObject({
+    digits: z.string(),
+});
+/**
+ * Hand the agent a fact from the tenant's backend: a slot freed, an order shipped, a payment
+ * confirmed. Lands as event.received with source app. The agent must have declared the name in its
+ * events with app among the senders, or the gateway answers error and nothing touches the log.
+ */
+export const CallEventSchema = z.strictObject({
+    name: z.string(),
+    data: z.record(z.string(), z.unknown()),
+});
+/** End the call from the app's side. call.ended follows with reason agent_hung_up. */
+export const CallHangupSchema = z.strictObject({
+    reason: z.string().nullish(),
+});
+/** Put the caller on hold: they hear hold audio, the agent hears nothing. */
+export const CallHoldSchema = z.strictObject({});
+/**
+ * Write a line of the app's own into the call's log. It gets a seq like everything else and lands
+ * as custom.
+ */
+export const CallLogSchema = z.strictObject({
+    name: z.string(),
+    data: z.record(z.string(), z.unknown()),
+});
+/** Mute the agent: it keeps listening and thinking, produces no audio. */
+export const CallMuteSchema = z.strictObject({});
+/**
+ * Send the caller to another number, or bring that number into the call. call.transferred says
+ * whether it worked, and which mode it was.
+ */
+export const CallTransferSchema = z.strictObject({
+    to: z.string(),
+    mode: TransferModeSchema.nullish(),
+});
+/** Take the caller off hold. */
+export const CallUnholdSchema = z.strictObject({});
+/** Unmute the agent. */
+export const CallUnmuteSchema = z.strictObject({});
+/**
+ * Why the verb did not run, in the words the console shows: the status it travels under, and the
+ * sentence.
+ */
+export const DevRefusalSchema = z.strictObject({
+    status: z.int(),
+    detail: z.string(),
+});
+/** What came of one dev.request, named by its id. */
+export const DevAnswerSchema = z.strictObject({
+    id: z.string(),
+    result: z.record(z.string(), z.unknown()).nullish(),
+    refused: DevRefusalSchema.nullish(),
+});
+/**
+ * Silence a participant for the rest of the call: their audio leaves the room, for everyone in it.
+ * Lands as track.unpublished for their microphone. There is no unmute; a leg that must speak again
+ * is invited again.
+ */
+export const ParticipantMuteSchema = z.strictObject({
+    identity: z.string(),
+});
+/**
+ * Put a participant out of the room. Lands as participant.left with reason participant_removed.
+ * Removing the caller ends the call.
+ */
+export const ParticipantRemoveSchema = z.strictObject({
+    identity: z.string(),
+});
+/** Is the socket alive? The gateway answers pong. */
+export const PingSchema = z.strictObject({});
+/**
+ * Rewrite one block of the prompt, whole, by name. The name must be one of the agent's declared
+ * blocks, or one of the default four; anything else is refused with the name.
+ */
+export const PromptSetSchema = z.strictObject({
+    name: z.string(),
+    text: z.string(),
+});
+/**
+ * Bring somebody else into the call's room. A second SIP leg dialed to a number is the warm path:
+ * the agent stays on with the caller while the other side answers. Lands as participant.joined
+ * when they arrive, or error when they do not.
+ */
+export const RoomInviteSchema = z.strictObject({
+    to: z.string(),
+    kind: z.enum(["sip", "participant"]),
+});
+/**
+ * Push a payload to a browser in the room over the DataChannel: a card to render, a form to open.
+ * Lands as room.sent with the size, never the payload. The widget listens on pinecall.ui; a topic
+ * of the tenant's own reaches the tenant's own page code.
+ */
+export const RoomSendSchema = z.strictObject({
+    topic: z.string(),
+    data: z.record(z.string(), z.unknown()),
+    to: z.string().nullish(),
+});
+/**
+ * Set up this one call before the first turn: the app's initial state, and any config that differs
+ * from the agent's defaults for this caller.
+ */
+export const SessionConfigureSchema = z.strictObject({
+    state: z.record(z.string(), z.unknown()).nullish(),
+    config: AgentConfigSchema.nullish(),
+});
+/** The app's state changed and this is all of it. The platform logs state.changed and re-renders. */
+export const StateSetSchema = z.strictObject({
+    state: z.record(z.string(), z.unknown()),
+    changed: z.array(z.string()).nullish(),
+});
+/** One supervise verb, from the human the door named. */
+export const SupervisorVerbSchema = z.strictObject({
+    by: SupervisorSchema,
+    verb: VerbSchema,
+});
+/**
+ * The tools the model may see now. The full list was declared in agent.configure; this is the
+ * subset whose when allows them in this state.
+ */
+export const ToolsSetSchema = z.strictObject({
+    tools: z.array(ToolSpecSchema),
+});
+//# sourceMappingURL=commands.js.map

package/dist/wire/commands.js.map

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

package/dist/wire/defs.d.ts

@@ -0,0 +1,373 @@
+/** 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 declare const ChannelSchema: z.ZodEnum<{
+    phone: "phone";
+    web: "web";
+    whatsapp: "whatsapp";
+}>;
+export type Channel = z.infer<typeof ChannelSchema>;
+/** How a call is had: spoken (`voice`) or written (`text`). A web call can be either. */
+export declare const MediumSchema: z.ZodEnum<{
+    text: "text";
+    voice: "voice";
+}>;
+export type Medium = z.infer<typeof MediumSchema>;
+/** Inbound: the public reached the agent. Outbound: the agent reached out (a dial). */
+export declare const DirectionSchema: z.ZodEnum<{
+    inbound: "inbound";
+    outbound: "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 declare const EnvSchema: z.ZodEnum<{
+    production: "production";
+    sandbox: "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 declare const DevVerbSchema: z.ZodEnum<{
+    "chat.end": "chat.end";
+    "chat.roster": "chat.roster";
+    "chat.say": "chat.say";
+    "chat.start": "chat.start";
+    "drift.read": "drift.read";
+    "goldens.roster": "goldens.roster";
+    "goldens.run": "goldens.run";
+    "knowledge.eval": "knowledge.eval";
+    "knowledge.push": "knowledge.push";
+    "knowledge.roster": "knowledge.roster";
+    "memory.eval": "memory.eval";
+    "memory.extraction": "memory.extraction";
+    "memory.roster": "memory.roster";
+    "promote.roster": "promote.roster";
+    "promote.write": "promote.write";
+    "reproductions.read": "reproductions.read";
+    "reproductions.roster": "reproductions.roster";
+    "simulate.start": "simulate.start";
+    "view.render": "view.render";
+}>;
+export type DevVerb = z.infer<typeof DevVerbSchema>;
+/**
+ * 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 declare const EndReasonSchema: z.ZodEnum<{
+    agent_hung_up: "agent_hung_up";
+    app_detached: "app_detached";
+    busy: "busy";
+    caller_hung_up: "caller_hung_up";
+    dial_failed: "dial_failed";
+    drained: "drained";
+    error: "error";
+    no_answer: "no_answer";
+    supervisor_ended: "supervisor_ended";
+    timeout: "timeout";
+    transferred: "transferred";
+}>;
+/** Whose action ended the call. platform covers timeouts, errors and a drained worker. */
+export declare const EndedBySchema: z.ZodEnum<{
+    agent: "agent";
+    caller: "caller";
+    platform: "platform";
+    supervisor: "supervisor";
+}>;
+/**
+ * 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 declare const ScoreVerdictSchema: z.ZodEnum<{
+    broken: "broken";
+    deferred: "deferred";
+    held: "held";
+    skipped: "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 declare const TransferModeSchema: z.ZodEnum<{
+    cold: "cold";
+    warm: "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 declare const PromptRegionSchema: z.ZodEnum<{
+    dynamic: "dynamic";
+    static: "static";
+}>;
+export type PromptRegion = z.infer<typeof PromptRegionSchema>;
+/**
+ * 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 declare const DocsModeSchema: z.ZodEnum<{
+    retrieved: "retrieved";
+    tool: "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 declare const PromptBlockSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    region: z.ZodEnum<{
+        dynamic: "dynamic";
+        static: "static";
+    }>;
+}, z.core.$strict>;
+export type PromptBlockSpec = z.infer<typeof PromptBlockSpecSchema>;
+/**
+ * What the platform believes the person on the line is doing right now. The states are the
+ * session's own.
+ */
+export declare const UserStateSchema: z.ZodEnum<{
+    away: "away";
+    listening: "listening";
+    speaking: "speaking";
+}>;
+/**
+ * What the agent is doing right now, in the session's own words: warming up, waiting, hearing the
+ * caller, generating, or playing audio.
+ */
+export declare const AgentStateSchema: z.ZodEnum<{
+    idle: "idle";
+    initializing: "initializing";
+    listening: "listening";
+    speaking: "speaking";
+    thinking: "thinking";
+}>;
+/**
+ * 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 declare const ParticipantKindSchema: z.ZodEnum<{
+    agent: "agent";
+    caller: "caller";
+    listener: "listener";
+    sip: "sip";
+    supervisor: "supervisor";
+}>;
+/** What a track carries: a microphone's audio, a camera's video, or a screen share. */
+export declare const TrackKindSchema: z.ZodEnum<{
+    audio: "audio";
+    screen: "screen";
+    video: "video";
+}>;
+/** Where a track comes from, as livekit's TrackSource names it, in lower case. */
+export declare const TrackSourceSchema: z.ZodEnum<{
+    camera: "camera";
+    microphone: "microphone";
+    screen_share: "screen_share";
+    screen_share_audio: "screen_share_audio";
+    unknown: "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 declare const EventSourceSchema: z.ZodEnum<{
+    app: "app";
+    participant: "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 declare const VisibilitySchema: z.ZodEnum<{
+    pii: "pii";
+    public: "public";
+    tenant: "tenant";
+}>;
+/**
+ * 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 declare const ProjectionSchema: z.ZodEnum<{
+    public: "public";
+    tenant: "tenant";
+}>;
+/**
+ * Who is on the line, as far as the platform knows. Everything is optional: a web visitor may be
+ * nobody yet.
+ */
+export declare const ContactSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type Contact = z.infer<typeof ContactSchema>;
+/**
+ * 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 declare const RouteSchema: z.ZodObject<{
+    channel: z.ZodEnum<{
+        phone: "phone";
+        web: "web";
+        whatsapp: "whatsapp";
+    }>;
+    number: z.ZodNullable<z.ZodString>;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type Route = z.infer<typeof RouteSchema>;
+/** The human who sent a supervise verb, as the token that let them in names them. */
+export declare const SupervisorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * What the app declares about one tool: the contract the model sees and the rules the platform
+ * enforces before running it.
+ */
+export declare const ToolSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    side_effect: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        irreversible: "irreversible";
+        read: "read";
+        write: "write";
+    }>>>;
+    confirm: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    pii: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    timeout_s: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type ToolSpec = z.infer<typeof ToolSpecSchema>;
+/**
+ * What came back from running a tool in the app's process. Either an output or an error, never
+ * both.
+ */
+export declare const ToolResultSchema: z.ZodObject<{
+    call_id: z.ZodString;
+    name: z.ZodString;
+    output: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    duration_s: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+export type ToolResult = z.infer<typeof ToolResultSchema>;
+/**
+ * One thing remembered about a contact: a sentence, where it came from, and how well it matched
+ * when recalled.
+ */
+export declare const MemoryFactSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodString;
+    category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    score: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * One operation against the contact's memory: a recall during the turn, a remember at hangup, or a
+ * forget on request.
+ */
+export declare const MemoryOpSchema: z.ZodObject<{
+    op: z.ZodEnum<{
+        forget: "forget";
+        recall: "recall";
+        remember: "remember";
+    }>;
+    contact: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    query: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    facts: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodString;
+        category: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        score: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    took_ms: z.ZodNumber;
+}, z.core.$strict>;
+/** One chunk of the knowledge base that retrieval put in front of the model for this turn. */
+export declare const DocSourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    base: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    path: z.ZodString;
+    heading: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    score: z.ZodNumber;
+    excerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/** One priced line: a model, what was counted, how much, and what it came to. */
+export declare const CostRowSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+    unit: z.ZodEnum<{
+        audio_seconds: "audio_seconds";
+        cache_creation_tokens: "cache_creation_tokens";
+        cached_input_tokens: "cached_input_tokens";
+        characters: "characters";
+        input_tokens: "input_tokens";
+        minutes: "minutes";
+        output_tokens: "output_tokens";
+        requests: "requests";
+        session_seconds: "session_seconds";
+    }>;
+    quantity: z.ZodNumber;
+    unit_price_usd: z.ZodNumber;
+    usd: z.ZodNumber;
+}, z.core.$strict>;
+/** A usage row the price table does not know. It is listed, never priced at zero. */
+export declare const UnpricedRowSchema: z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+}, z.core.$strict>;
+/**
+ * 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 declare const CostSchema: z.ZodObject<{
+    usd: z.ZodNumber;
+    rows: z.ZodArray<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+        unit: z.ZodEnum<{
+            audio_seconds: "audio_seconds";
+            cache_creation_tokens: "cache_creation_tokens";
+            cached_input_tokens: "cached_input_tokens";
+            characters: "characters";
+            input_tokens: "input_tokens";
+            minutes: "minutes";
+            output_tokens: "output_tokens";
+            requests: "requests";
+            session_seconds: "session_seconds";
+        }>;
+        quantity: z.ZodNumber;
+        unit_price_usd: z.ZodNumber;
+        usd: z.ZodNumber;
+    }, z.core.$strict>>;
+    unpriced: z.ZodArray<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Cost = z.infer<typeof CostSchema>;
+//# sourceMappingURL=defs.d.ts.map

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

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