@pinecall/agents 0.9.20

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

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

package/dist/wire/state.js

@@ -0,0 +1,189 @@
+/** What a log reduces to: the call, its turns, its tools, its people, its metrics. */
+import { z } from "zod";
+import { AgentStateSchema, ChannelSchema, ContactSchema, CostSchema, DirectionSchema, DocSourceSchema, EndReasonSchema, EventSourceSchema, MemoryOpSchema, ParticipantKindSchema, RouteSchema, SupervisorSchema, TransferModeSchema, UserStateSchema, } from "./defs.js";
+import { AgentTurnMetricsSchema, AvatarMetricsSchema, EOTInferenceMetricsSchema, EOUMetricsSchema, InterruptionMetricsSchema, LLMMetricsSchema, ModelUsageSchema, RealtimeModelMetricsSchema, STTMetricsSchema, TTSMetricsSchema, UserTurnMetricsSchema, VADMetricsSchema, } from "./metrics.js";
+/**
+ * Where the call is in its life. idle before any call.* entry, which is what an agent's own log
+ * looks like.
+ */
+export const CallStatusSchema = z.enum(["idle", "ringing", "dialing", "active", "ended"]);
+/** One finished turn of the caller, with what the session measured about it. */
+export const UserTurnSchema = z.strictObject({
+    role: z.literal("user"),
+    speech_id: z.string(),
+    item_id: z.string().nullish(),
+    text: z.string(),
+    language: z.string().nullish(),
+    transcript_confidence: z.number().nullish(),
+    metrics: UserTurnMetricsSchema,
+});
+/** One finished reply of the agent, with what the session measured about it. */
+export const AgentTurnSchema = z.strictObject({
+    role: z.literal("agent"),
+    speech_id: z.string(),
+    item_id: z.string().nullish(),
+    text: z.string(),
+    interrupted: z.boolean(),
+    metrics: AgentTurnMetricsSchema,
+});
+/** One turn of either side, told apart by role. */
+export const TurnSchema = z.discriminatedUnion("role", [UserTurnSchema, AgentTurnSchema]);
+/**
+ * Every raw metric block of the call, by kind, in the order it arrived. The turns hold the join;
+ * this holds the measurements.
+ */
+export const CollectedMetricsSchema = z.strictObject({
+    llm: z.array(LLMMetricsSchema),
+    stt: z.array(STTMetricsSchema),
+    tts: z.array(TTSMetricsSchema),
+    vad: z.array(VADMetricsSchema),
+    eou: z.array(EOUMetricsSchema),
+    eot: z.array(EOTInferenceMetricsSchema),
+    interruption: z.array(InterruptionMetricsSchema),
+    realtime: z.array(RealtimeModelMetricsSchema),
+    avatar: z.array(AvatarMetricsSchema),
+});
+/** One tool call and, once the app answered, its result. */
+export const ToolRunSchema = z.strictObject({
+    call_id: z.string(),
+    name: z.string(),
+    arguments: z.record(z.string(), z.unknown()),
+    speech_id: z.string().nullish(),
+    status: z.enum(["running", "done", "failed"]),
+    output: z.unknown().nullish(),
+    error: z.string().nullish(),
+    summary: z.string().nullish(),
+    duration_s: z.number().nullish(),
+    seq: z.int(),
+});
+/** What is known about one block of the prompt without storing its text. */
+export const PromptBlockStateSchema = z.strictObject({
+    hash: z.string(),
+    chars: z.int(),
+    seq: z.int(),
+});
+/**
+ * Every block the app has written, by name, without its text. The history between the static and
+ * the dynamic blocks is the turns.
+ */
+export const PromptStateSchema = z.record(z.string(), PromptBlockStateSchema);
+/** One confirmation the platform asked for, and how it went. */
+export const ConfirmSchema = z.strictObject({
+    tool: z.string(),
+    call_id: z.string(),
+    audience: z.string(),
+    phrase: z.string(),
+    status: z.enum(["pending", "granted", "declined"]),
+    said: z.string().nullish(),
+    reason: z.string().nullish(),
+});
+/** Whether a supervisor holds the line right now. */
+export const HandoffSchema = z.strictObject({
+    active: z.boolean(),
+    by: SupervisorSchema.nullable(),
+});
+/** The transfer in flight or the one that happened. */
+export const TransferStateSchema = z.strictObject({
+    to: z.string(),
+    mode: TransferModeSchema.nullable().nullish(),
+    status: z.enum(["requested", "done", "failed"]),
+    by: z.enum(["agent", "supervisor"]),
+});
+/** The agent's last ask for a person, from attention.requested until attention.answered settles it. */
+export const AttentionStateSchema = z.strictObject({
+    reason: z.string(),
+    wait_s: z.number(),
+    status: z.enum(["open", "answered", "lapsed"]),
+    asked_at: z.number(),
+    by: SupervisorSchema.nullable(),
+});
+/** The words on screen right now: interim transcripts that a finished turn clears. */
+export const LiveTranscriptSchema = z.strictObject({
+    user: z.string().nullable(),
+    agent: z.string().nullable(),
+});
+/** A stretch of seqs this reader never saw. */
+export const GapSchema = z.strictObject({
+    from_seq: z.int(),
+    to_seq: z.int(),
+});
+/** An error entry, kept so the console can show what went wrong and when. */
+export const LoggedErrorSchema = z.strictObject({
+    seq: z.int(),
+    code: z.string(),
+    message: z.string(),
+});
+/** One participant in the room right now, as the room reported them when they joined. */
+export const ParticipantSchema = z.strictObject({
+    identity: z.string(),
+    kind: ParticipantKindSchema,
+    name: z.string().nullish(),
+    joined_at: z.number(),
+    speaking: z.boolean(),
+    attributes: z.record(z.string(), z.unknown()),
+});
+/** The LiveKit room the call lives in, and who is in it right now. */
+export const RoomSchema = z.strictObject({
+    name: z.string(),
+    sid: z.string(),
+    participants: z.array(ParticipantSchema),
+    caller: z.string().nullable(),
+});
+/**
+ * One fact that reached the agent from outside the conversation, kept by name and origin. Its data
+ * is in the log at that seq.
+ */
+export const ReceivedEventSchema = z.strictObject({
+    seq: z.int(),
+    name: z.string(),
+    source: EventSourceSchema,
+    identity: z.string().nullish(),
+});
+/** A line the app wrote into the log with call.log. */
+export const CustomNoteSchema = z.strictObject({
+    seq: z.int(),
+    name: z.string(),
+    data: z.record(z.string(), z.unknown()),
+});
+/** The whole of what a log says, at the seq it was read to. */
+export const StateSchema = z.strictObject({
+    seq: z.int(),
+    agent: z.string(),
+    call: z.string().nullable(),
+    status: CallStatusSchema,
+    channel: ChannelSchema.nullable(),
+    direction: DirectionSchema.nullable(),
+    from: z.string().nullable(),
+    to: z.string().nullable(),
+    caller: ContactSchema.nullable(),
+    room: RoomSchema.nullable(),
+    started_at: z.number().nullable(),
+    ended_at: z.number().nullable(),
+    end_reason: EndReasonSchema.nullable(),
+    outcome: z.string().nullable(),
+    user_state: UserStateSchema.nullable(),
+    agent_state: AgentStateSchema.nullable(),
+    live: LiveTranscriptSchema,
+    turns: z.array(TurnSchema),
+    metrics: CollectedMetricsSchema,
+    tools: z.array(ToolRunSchema),
+    app_state: z.record(z.string(), z.unknown()),
+    events: z.array(ReceivedEventSchema),
+    prompt: PromptStateSchema,
+    tools_visible: z.array(z.string()),
+    confirms: z.array(ConfirmSchema),
+    memory: z.array(MemoryOpSchema),
+    sources: z.array(DocSourceSchema),
+    handoff: HandoffSchema,
+    held: z.boolean(),
+    muted: z.boolean(),
+    transfer: TransferStateSchema.nullable(),
+    attention: AttentionStateSchema.nullable().nullish(),
+    usage: z.array(ModelUsageSchema),
+    cost: CostSchema.nullable(),
+    routes: z.array(RouteSchema),
+    gaps: z.array(GapSchema),
+    errors: z.array(LoggedErrorSchema),
+    custom: z.array(CustomNoteSchema),
+});
+//# sourceMappingURL=state.js.map

package/dist/wire/state.js.map

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

package/dist/wire/verbs.d.ts

@@ -0,0 +1,73 @@
+/** The verbs a supervisor sends a call. */
+import { z } from "zod";
+/** Make the agent say this, verbatim, to the caller. Logged as supervisor.said. */
+export declare const SayVerbSchema: z.ZodObject<{
+    verb: z.ZodLiteral<"say">;
+    text: z.ZodString;
+}, z.core.$strict>;
+/**
+ * Tell the agent something the caller never hears. It reaches the agent as an instruction for its
+ * next reply; logged as supervisor.whispered.
+ */
+export declare const WhisperVerbSchema: z.ZodObject<{
+    verb: z.ZodLiteral<"whisper">;
+    text: z.ZodString;
+}, z.core.$strict>;
+/**
+ * The supervisor takes the line: the agent goes quiet and the supervisor's audio replaces it.
+ * Logged as supervisor.took_over.
+ */
+export declare const TakeoverVerbSchema: z.ZodObject<{
+    verb: z.ZodLiteral<"takeover">;
+}, z.core.$strict>;
+/**
+ * The supervisor hands the line back to the agent, which resumes with the history intact. Logged
+ * as supervisor.released.
+ */
+export declare const ReleaseVerbSchema: z.ZodObject<{
+    verb: z.ZodLiteral<"release">;
+}, z.core.$strict>;
+/**
+ * Send the caller to another number. Logged as supervisor.transferred, then call.transferred says
+ * whether it worked.
+ */
+export declare const TransferVerbSchema: z.ZodObject<{
+    verb: z.ZodLiteral<"transfer">;
+    to: z.ZodString;
+    mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        cold: "cold";
+        warm: "warm";
+    }>>>;
+}, z.core.$strict>;
+/**
+ * Hang up on the caller's behalf, at once: a sentence playing and a reply still being written are
+ * cut, not finished. Logged as supervisor.ended, then call.ended with reason supervisor_ended.
+ */
+export declare const EndVerbSchema: z.ZodObject<{
+    verb: z.ZodLiteral<"end">;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/** One supervise verb, told apart by its verb field. */
+export declare const VerbSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    verb: z.ZodLiteral<"say">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    verb: z.ZodLiteral<"whisper">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    verb: z.ZodLiteral<"takeover">;
+}, z.core.$strict>, z.ZodObject<{
+    verb: z.ZodLiteral<"release">;
+}, z.core.$strict>, z.ZodObject<{
+    verb: z.ZodLiteral<"transfer">;
+    to: z.ZodString;
+    mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        cold: "cold";
+        warm: "warm";
+    }>>>;
+}, z.core.$strict>, z.ZodObject<{
+    verb: z.ZodLiteral<"end">;
+    reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>], "verb">;
+export type Verb = z.infer<typeof VerbSchema>;
+//# sourceMappingURL=verbs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verbs.d.ts","sourceRoot":"","sources":["../../src/wire/verbs.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,mFAAmF;AACnF,eAAO,MAAM,aAAa;;;kBAGxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;kBAG5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;kBAE7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;kBAE5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;kBAI7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;kBAGxB,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;4BAA6I,CAAC;AAErK,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/wire/verbs.js

@@ -0,0 +1,50 @@
+/** The verbs a supervisor sends a call. */
+import { z } from "zod";
+import { TransferModeSchema } from "./defs.js";
+/** Make the agent say this, verbatim, to the caller. Logged as supervisor.said. */
+export const SayVerbSchema = z.strictObject({
+    verb: z.literal("say"),
+    text: z.string(),
+});
+/**
+ * Tell the agent something the caller never hears. It reaches the agent as an instruction for its
+ * next reply; logged as supervisor.whispered.
+ */
+export const WhisperVerbSchema = z.strictObject({
+    verb: z.literal("whisper"),
+    text: z.string(),
+});
+/**
+ * The supervisor takes the line: the agent goes quiet and the supervisor's audio replaces it.
+ * Logged as supervisor.took_over.
+ */
+export const TakeoverVerbSchema = z.strictObject({
+    verb: z.literal("takeover"),
+});
+/**
+ * The supervisor hands the line back to the agent, which resumes with the history intact. Logged
+ * as supervisor.released.
+ */
+export const ReleaseVerbSchema = z.strictObject({
+    verb: z.literal("release"),
+});
+/**
+ * Send the caller to another number. Logged as supervisor.transferred, then call.transferred says
+ * whether it worked.
+ */
+export const TransferVerbSchema = z.strictObject({
+    verb: z.literal("transfer"),
+    to: z.string(),
+    mode: TransferModeSchema.nullish(),
+});
+/**
+ * Hang up on the caller's behalf, at once: a sentence playing and a reply still being written are
+ * cut, not finished. Logged as supervisor.ended, then call.ended with reason supervisor_ended.
+ */
+export const EndVerbSchema = z.strictObject({
+    verb: z.literal("end"),
+    reason: z.string().nullish(),
+});
+/** One supervise verb, told apart by its verb field. */
+export const VerbSchema = z.discriminatedUnion("verb", [SayVerbSchema, WhisperVerbSchema, TakeoverVerbSchema, ReleaseVerbSchema, TransferVerbSchema, EndVerbSchema]);
+//# sourceMappingURL=verbs.js.map

package/dist/wire/verbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbs.js","sourceRoot":"","sources":["../../src/wire/verbs.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,mFAAmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;CAC5B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,kBAAkB,CAAC,OAAO,EAAE;CACnC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;CAC7B,CAAC,CAAC;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@pinecall/agents",
+  "version": "0.9.20",
+  "description": "Write an agent as a class: its fields are the state, its @tool methods are the model's verbs, and its docstrings are the prompt. The pinecall CLI serves it",
+  "license": "Apache-2.0",
+  "author": "Pinecall <hello@pinecall.io>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pinecall/agents.git"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./panels": {
+      "types": "./dist/views/panels.d.ts",
+      "import": "./dist/views/panels.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./client/testing": {
+      "types": "./dist/client/testing/index.d.ts",
+      "import": "./dist/client/testing/index.js"
+    },
+    "./serve": {
+      "types": "./dist/serve/index.d.ts",
+      "import": "./dist/serve/index.js",
+      "default": "./dist/serve/index.js"
+    },
+    "./wire": {
+      "types": "./dist/wire/index.d.ts",
+      "import": "./dist/wire/index.js"
+    },
+    "./views/jsx-runtime": {
+      "types": "./dist/views/jsx-runtime.d.ts",
+      "import": "./dist/views/jsx-runtime.js"
+    },
+    "./views/jsx-dev-runtime": {
+      "types": "./dist/views/jsx-dev-runtime.d.ts",
+      "import": "./dist/views/jsx-dev-runtime.js"
+    },
+    "./tsconfig.tenant.json": "./tsconfig.tenant.json"
+  },
+  "files": [
+    "dist",
+    "tsconfig.tenant.json"
+  ],
+  "dependencies": {
+    "oxc-parser": "^0.148.0",
+    "tsx": "^4.20.6",
+    "ws": "^8.21.3",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "@types/ws": "^8.18.1",
+    "typescript": "7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "scripts/build",
+    "lint": "tsc -p tsconfig.lint.json",
+    "test": "vitest run"
+  }
+}

package/tsconfig.tenant.json

@@ -0,0 +1,24 @@
+{
+  // The tsconfig a tenant extends, and the only place the framework's compiler flags are written.
+  // An agent is a class with `@tool` methods and a `.tsx` view, and both need the compiler told
+  // something: `@tool` and `@state` are LEGACY TypeScript decorators (docs/decisions/agent.md has
+  // the measurement — vite 8 / rolldown-oxc transforms no other kind), and a view compiles against
+  // our own text runtime instead of React's. A tenant should not have to know either fact, so it
+  // inherits both from here:
+  //
+  //     { "extends": "@pinecall/agents/tsconfig.tenant.json", "include": ["agents", "test"] }
+  //
+  // Nothing here is about the framework's own build; that lives in tsconfig.json beside it.
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "experimentalDecorators": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "@pinecall/agents/views"
+  }
+}