@arnilo/prism 0.6.0 → 0.7.0

package/templates/business-worker/tsconfig.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
+}

package/templates/personal-assistant/README.md.tmpl

@@ -0,0 +1,18 @@
+# __PROJECT_NAME__
+
+Personal workstation assistant built with Prism. Features single-user ownership, local tools, credential references, and loopback dev inspection.
+
+## Quickstart
+
+```bash
+npm install
+npm test
+npm run dev    # Boots loopback dev inspector at http://127.0.0.1:4311
+```
+
+## Security Posture
+
+- **Single-User Ownership**: Bounded to the local workstation operator (`userId: process.env.USER`).
+- **Secret Redaction**: Environment secrets are redacted before persistence or logs.
+- **Durable Verification**: Uses memory/local storage; in-memory storage is recognized as non-durable.
+- **Containment**: Tool actions are contained to local workspace roots.

package/templates/personal-assistant/env.example.tmpl

@@ -0,0 +1 @@
+OPENAI_API_KEY=

package/templates/personal-assistant/gitignore.tmpl

@@ -0,0 +1,11 @@
+node_modules/
+dist/
+.env
+.env.local
+*.db
+*.sqlite
+*.sqlite3
+.prism/
+coverage/
+.DS_Store
+*.log

package/templates/personal-assistant/manifest.json

@@ -0,0 +1,11 @@
+{
+  "name": "personal-assistant",
+  "description": "Personal workstation assistant: local single-user agent with file tools, credential references, and loopback dev inspection",
+  "version": "0.1.0",
+  "tags": ["personal", "workstation", "assistant", "local", "secure"],
+  "packages": [
+    "@arnilo/prism",
+    "@arnilo/prism-core",
+    "@arnilo/prism-providers"
+  ]
+}

package/templates/personal-assistant/package.json.tmpl

@@ -0,0 +1,23 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test dist/__tests__/agent.test.js",
+    "start": "npm run build && node dist/index.js",
+    "dev": "prism dev"
+  },
+  "dependencies": {
+__DEPENDENCIES__
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/templates/personal-assistant/src/agent.ts.tmpl

@@ -0,0 +1,65 @@
+import {
+  type Agent,
+  createMemoryCheckpointStore,
+  createMockProvider,
+  createSecretRedactor,
+  createSecureAgent,
+  createStaticPermissionPolicy,
+  createStaticTrustPolicy,
+  providerDone,
+  providerTextDelta,
+} from "@arnilo/prism";
+import { createJsonSchemaArgumentValidator } from "@arnilo/prism-core/validation/json-schema";
+
+export interface CreatePersonalAgentOptions {
+  readonly userId?: string;
+  readonly provider?: import("@arnilo/prism").AIProvider;
+  readonly model?: { readonly provider: string; readonly model: string };
+  readonly workspaceRoot?: string;
+}
+
+export function createAppAgent(options: CreatePersonalAgentOptions = {}): Agent {
+  const userId = options.userId ?? process.env.USER ?? "local-user";
+  const redactor = createSecretRedactor(
+    [process.env.OPENAI_API_KEY].filter((v): v is string => typeof v === "string" && v.length > 0),
+  );
+
+  const provider =
+    options.provider ??
+    createMockProvider([
+      providerTextDelta("Personal Assistant ready. How can I help you today?"),
+      providerDone(),
+    ]);
+
+  return createSecureAgent({
+    id: "personal-assistant",
+    definitionRevision: "1",
+    ownership: { userId },
+    redactor,
+    permission: createStaticPermissionPolicy(true),
+    trust: createStaticTrustPolicy(true),
+    toolArgumentValidator: createJsonSchemaArgumentValidator(),
+    limits: { maxToolRounds: 10 },
+    runState: { checkpoints: createMemoryCheckpointStore() },
+    tools: [
+      {
+        name: "workspace_status",
+        description: "Reports the local workspace status and configuration",
+        parameters: {
+          type: "object",
+          properties: {
+            details: { type: "boolean", description: "Include detailed status" },
+          },
+          additionalProperties: false,
+        },
+        execute: async (_args, ctx) => ({
+          toolCallId: ctx.toolCallId,
+          name: "workspace_status",
+          value: { ok: true, user: userId, status: "active" },
+        }),
+      },
+    ],
+    provider,
+    model: options.model ?? { provider: "mock", model: "personal-default" },
+  });
+}

package/templates/personal-assistant/src/index.ts.tmpl

@@ -0,0 +1,13 @@
+import { createAppAgent } from "./agent.js";
+
+async function main() {
+  const agent = createAppAgent();
+  const session = agent.createSession({ id: "personal-session-1" });
+  const result = await session.run("Check workspace status");
+  console.log(result.text);
+}
+
+main().catch((error) => {
+  console.error("Personal assistant failed:", error);
+  process.exit(1);
+});

package/templates/personal-assistant/src/tests/agent.test.ts.tmpl

@@ -0,0 +1,28 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { assertHostCompositionReadiness, inspectHostComposition } from "@arnilo/prism";
+import { createAppAgent } from "../agent.js";
+
+describe("personal assistant template", () => {
+  it("creates agent and runs an offline turn", async () => {
+    const agent = createAppAgent({ userId: "test-user" });
+    const session = agent.createSession({ id: "test-session" });
+    const result = await session.run("Hello");
+    assert.ok(result.text.includes("Personal Assistant ready"));
+  });
+
+  it("passes personal host composition readiness inspection", () => {
+    const agent = createAppAgent({ userId: "test-user" });
+    const report = inspectHostComposition({
+      profile: "personal",
+      agent,
+      credentialRefs: ["OPENAI_API_KEY"],
+    });
+
+    assert.equal(report.profile, "personal");
+    assert.equal(report.ownership.userId, "test-user");
+    assert.equal(report.readiness.ok, true);
+    assert.equal(report.storage.durable, false, "in-memory store is non-durable");
+    assert.doesNotThrow(() => assertHostCompositionReadiness({ profile: "personal", agent }));
+  });
+});

package/templates/personal-assistant/tsconfig.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
+}