pinecall 0.1.0

package/dist/views/render.d.ts

@@ -0,0 +1,19 @@
+/** Rendering the prompt: the blocks for the runtime, and the same blocks as a page a human reads. */
+import type { PromptRegion } from "@pinecall/protocol";
+import type { Agent } from "../agent/agent.js";
+import { type Blocks } from "./layout.js";
+/** The prompt of this agent right now, block by block, in the order the runtime sends them. */
+export declare function promptOf(agent: Agent): Blocks;
+/**
+ * The header a section of the printed page carries: a block's name with its region beside it, or a
+ * bare name for the history and for the `tools` page the CLI prints under the prompt. One
+ * definition, so every page is ruled the same way.
+ */
+export declare function headerFor(name: string, region?: PromptRegion): string;
+/**
+ * The whole prompt as one page: every static block under its header, then the history, then the
+ * view. What `pinecall run --show-prompt` prints: the headers make it obvious at a glance which
+ * blocks are cached and which one is rewritten every turn.
+ */
+export declare function showPrompt(agent: Agent): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/views/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/views/render.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAErG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAElD,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAO/C"}

package/dist/views/render.js

@@ -0,0 +1,26 @@
+/** Rendering the prompt: the blocks for the runtime, and the same blocks as a page a human reads. */
+import { layout } from "./layout.js";
+/** The prompt of this agent right now, block by block, in the order the runtime sends them. */
+export function promptOf(agent) {
+    return layout(agent);
+}
+/**
+ * The header a section of the printed page carries: a block's name with its region beside it, or a
+ * bare name for the history and for the `tools` page the CLI prints under the prompt. One
+ * definition, so every page is ruled the same way.
+ */
+export function headerFor(name, region) {
+    return region === undefined ? `── ${name} ──` : `── ${name} (${region}) ──`;
+}
+/**
+ * The whole prompt as one page: every static block under its header, then the history, then the
+ * view. What `pinecall run --show-prompt` prints: the headers make it obvious at a glance which
+ * blocks are cached and which one is rewritten every turn.
+ */
+export function showPrompt(agent) {
+    const { blocks, history } = promptOf(agent);
+    const section = (name, text, region) => `${headerFor(name, region)}\n${text}`.trimEnd();
+    const of = (region) => blocks.filter((block) => block.region === region).map((block) => section(block.name, block.text, region));
+    return [...of("static"), section("history", history), ...of("dynamic")].join("\n\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/views/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/views/render.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAKrG,OAAO,EAAE,MAAM,EAAe,MAAM,aAAa,CAAC;AAElD,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,KAAY;IACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAqB;IAC3D,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,MAAM,MAAM,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,MAAqB,EAAU,EAAE,CAC5E,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,EAAE,GAAG,CAAC,MAAoB,EAAY,EAAE,CAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5G,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvF,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "pinecall",
+  "version": "0.1.0",
+  "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",
+  "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",
+  "bin": {
+    "pinecall": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.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"
+    },
+    "./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": {
+    "@pinecall/protocol": "^0.1.0",
+    "oxc-parser": "^0.148.0",
+    "tsx": "^4.20.6",
+    "ws": "^8.21.3",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.7",
+    "@types/ws": "^8.18.1",
+    "@vitejs/plugin-react": "^6.1.1",
+    "livekit-client": "^2.22.3",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-router": "^8.3.1",
+    "typescript": "7.0.2",
+    "vite": "^8.2.2",
+    "vitest": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "optionalDependencies": {
+    "@livekit/rtc-node": "^0.13.35"
+  },
+  "scripts": {
+    "build": "scripts/build",
+    "lint": "tsc -p tsconfig.lint.json && tsc -p tsconfig.console.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/tsconfig.tenant.json", "include": ["agent.ts", "views"] }
+  //
+  // 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/views"
+  }
+}