@zmzai/agent-framework 0.1.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,28 @@
+/** @zmzai/agent-framework — PI-based agent framework (OpenCode-style).
+ *  Storage/backend-agnostic: sessions, permissions, tools, runner, events.
+ *  Assemble with createServer() (or wire SessionRunner directly). */
+export { newSessionId, newMessageId, newPartId, newPermissionRequestId, newEventId } from "./core/session/ids.js";
+export { createJsonlSessionStore } from "./core/session/jsonl-store.js";
+export { frameworkEventSchemas, parseFrameworkEvent } from "./core/events/manifest.js";
+export { createMemoryEventLog, subscribeEventLog, notifyEventLogListeners } from "./core/events/bus.js";
+export { rulesetFromConfig, evaluateRules, wildcardMatch, PERMISSIONS } from "./core/permission/ruleset.js";
+export { PermissionEngine, RejectedError } from "./core/permission/engine.js";
+export { AgentRegistry, builtinAgents, builtinDefaults } from "./core/agent/registry.js";
+export { loadCustomAgents } from "./core/agent/loader.js";
+export { parseAgentPlugin, parsePluginManifest, parsePluginMcp } from "./core/agent/plugin.js";
+export { adaptTool, permissionForCall } from "./core/tools/adapter.js";
+export { builtinTools, readTool, globTool, grepTool, writeTool, editTool, todoTool, bashTool } from "./core/tools/builtins.js";
+export { taskTool } from "./core/tools/task.js";
+// core: runtime
+export { SessionRunner, createFrameworkSession, isSessionActive } from "./core/runtime/runner.js";
+export { PartProjector, serializeEmit } from "./core/runtime/pi-bridge.js";
+export { buildCompactionTransform, createCompactionTransform, streamOneText } from "./core/runtime/compaction.js";
+export { startLeaseRecovery, reclaimExpiredLeases, finalizeInterruptedRun } from "./core/runtime/lease-recovery.js";
+export { noopSandboxExecutor, leaseDurationMs } from "./adapters/index.js";
+export { qaCheckResultSchema, qaCheckTool } from "./core/tools/qa-check.js";
+export { createFsWorkspaceFiles } from "./adapters/fs-workspace.js";
+export { createOpenAiModelProvider } from "./adapters/openai-provider.js";
+export { createSubprocessSandbox } from "./adapters/subprocess-sandbox.js";
+// server
+export { createServer } from "./server/create-server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;qEAEqE;AAKrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClH,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAIxE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIxG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE5G,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI9E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM/F,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC/H,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAmB,MAAM,0BAA0B,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAA2B,MAAM,kCAAkC,CAAC;AAI7I,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAsB,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,SAAS;AACT,OAAO,EAAE,YAAY,EAA2C,MAAM,2BAA2B,CAAC"}

package/dist/server/create-server.d.ts

@@ -0,0 +1,51 @@
+import { SessionRunner } from "../core/runtime/runner.js";
+import { AgentRegistry } from "../core/agent/registry.js";
+import type { SessionStore } from "../core/session/store.js";
+import type { EventLog } from "../core/events/bus.js";
+import type { WorkspaceFiles } from "../core/tools/context.js";
+import type { SandboxExecutor } from "../adapters/index.js";
+import type { SessionInfo, ModelRef } from "../core/session/types.js";
+import type { ModelProvider } from "../adapters/index.js";
+/** createServer (M5 spec §1/§4): assembles a self-contained agent framework
+ *  from injected backends. The product binds Mongo store + relay provider +
+ *  OpenSandbox; the CLI binds JSONL store + OpenAI provider + subprocess
+ *  sandbox + FS workspace. Either way the returned object is the whole
+ *  framework: runner, store, event log, registry. */
+export type FrameworkDeps = {
+    store: SessionStore;
+    eventLog: EventLog;
+    modelProvider: ModelProvider;
+    workspaceFor: (session: SessionInfo) => WorkspaceFiles;
+    sandbox?: SandboxExecutor;
+    registry?: AgentRegistry;
+    loadWorkspaceAgents?: (session: SessionInfo) => Promise<import("../core/agent/registry.js").AgentInfo[]>;
+    subagentDepth?: number;
+    compaction?: {
+        enabled: boolean;
+        contextWindow: number;
+        summaryModel: import("@earendil-works/pi-ai").Model<import("@earendil-works/pi-ai").Api> | null;
+    };
+    leaseStore?: {
+        stamp(sessionId: string, owner: string, expiresAt: Date): Promise<void>;
+        clear(sessionId: string): Promise<void>;
+    };
+};
+export type AgentFramework = {
+    runner: SessionRunner;
+    store: SessionStore;
+    eventLog: EventLog;
+    registry: AgentRegistry;
+    /** Creates a session bound to a workspace + user, optionally with an initial
+     *  prompt that starts running immediately. */
+    createSession(input: {
+        userId: string;
+        workspaceId: string;
+        agent?: string;
+        model: ModelRef;
+        prompt?: string;
+        parentId?: string;
+        title?: string;
+    }): Promise<SessionInfo>;
+};
+export declare function createServer(deps: FrameworkDeps): AgentFramework;
+//# sourceMappingURL=create-server.d.ts.map

package/dist/server/create-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA0B,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;qDAIqD;AAErD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,cAAc,CAAC;IACvD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,2BAA2B,EAAE,SAAS,EAAE,CAAC,CAAC;IACzG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,uBAAuB,EAAE,KAAK,CAAC,OAAO,uBAAuB,EAAE,GAAG,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1J,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACnI,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB;kDAC8C;IAC9C,aAAa,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1K,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAyBhE"}

package/dist/server/create-server.js

@@ -0,0 +1,29 @@
+import { SessionRunner, createFrameworkSession } from "../core/runtime/runner.js";
+import { AgentRegistry } from "../core/agent/registry.js";
+import { noopSandboxExecutor } from "../adapters/index.js";
+export function createServer(deps) {
+    const registry = deps.registry ?? new AgentRegistry();
+    const runner = new SessionRunner({
+        store: deps.store,
+        registry,
+        streamFnFor: (session) => deps.modelProvider.streamFor(session),
+        modelFor: (ref) => deps.modelProvider.getModel(ref),
+        eventLog: deps.eventLog,
+        workspaceFor: deps.workspaceFor,
+        sandbox: deps.sandbox ?? noopSandboxExecutor(),
+        ...(deps.loadWorkspaceAgents ? { loadWorkspaceAgents: deps.loadWorkspaceAgents } : {}),
+        subagentDepth: deps.subagentDepth ?? 1,
+        ...(deps.compaction ? { compaction: deps.compaction } : {}),
+        ...(deps.leaseStore ? { leaseStore: deps.leaseStore } : {}),
+    });
+    return {
+        runner,
+        store: deps.store,
+        eventLog: deps.eventLog,
+        registry,
+        async createSession(input) {
+            return createFrameworkSession({ store: deps.store, ...input });
+        },
+    };
+}
+//# sourceMappingURL=create-server.js.map

package/dist/server/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAiC3D,MAAM,UAAU,YAAY,CAAC,IAAmB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ;QACR,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC;QAC/D,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mBAAmB,EAAE;QAC9C,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ;QACR,KAAK,CAAC,aAAa,CAAC,KAAK;YACvB,OAAO,sBAAsB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/openapi.yaml

@@ -0,0 +1,239 @@
+openapi: 3.0.3
+info:
+  title: ZMZAI Agent Framework
+  description: |
+    PI-based agent framework HTTP surface (M5 spec §3). Session lifecycle,
+    prompt, permission replies and the SSE event stream. All endpoints are
+    auth-agnostic — the product binds its own auth middleware.
+  version: 0.1.0
+paths:
+  /sessions:
+    post:
+      summary: Create a session (optionally starting a run)
+      operationId: createSession
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [workspaceId, model]
+              properties:
+                workspaceId: { type: string }
+                agent: { type: string, default: "default" }
+                model:
+                  type: object
+                  required: [providerId, modelId]
+                  properties:
+                    providerId: { type: string }
+                    modelId: { type: string }
+                prompt: { type: string, description: "Initial prompt; starts the run immediately." }
+      responses:
+        "201":
+          description: Session created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SessionInfo"
+    get:
+      summary: List sessions
+      operationId: listSessions
+      parameters:
+        - name: workspaceId
+          in: query
+          schema: { type: string }
+      responses:
+        "200":
+          description: Session list
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  sessions: { type: array, items: { $ref: "#/components/schemas/SessionInfo" } }
+  /sessions/{sessionId}:
+    get:
+      summary: Session detail (info + messages + parts)
+      operationId: getSession
+      parameters:
+        - name: sessionId
+          in: path
+          required: true
+          schema: { type: string }
+      responses:
+        "200":
+          description: Session snapshot
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  session: { $ref: "#/components/schemas/SessionInfo" }
+                  messages:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        info: { $ref: "#/components/schemas/MessageInfo" }
+                        parts: { type: array, items: { $ref: "#/components/schemas/Part" } }
+  /sessions/{sessionId}/prompt:
+    post:
+      summary: Submit a prompt (queued when the session is busy)
+      operationId: prompt
+      parameters:
+        - name: sessionId
+          in: path
+          required: true
+          schema: { type: string }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [text]
+              properties:
+                text: { type: string }
+                agent: { type: string }
+      responses:
+        "202":
+          description: Accepted
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  accepted: { type: boolean }
+                  queued: { type: boolean }
+  /sessions/{sessionId}/abort:
+    post:
+      summary: Abort the active run and clear the prompt queue
+      operationId: abort
+      parameters:
+        - name: sessionId
+          in: path
+          required: true
+          schema: { type: string }
+      responses:
+        "200":
+          description: Aborted
+  /sessions/{sessionId}/permissions/{requestId}:
+    post:
+      summary: Reply to a permission request (once/always/reject)
+      operationId: replyPermission
+      parameters:
+        - name: sessionId
+          in: path
+          required: true
+          schema: { type: string }
+        - name: requestId
+          in: path
+          required: true
+          schema: { type: string }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [reply]
+              properties:
+                reply: { type: string, enum: [once, always, reject] }
+                feedback: { type: string }
+      responses:
+        "200":
+          description: Resolved
+  /sessions/{sessionId}/events:
+    get:
+      summary: SSE event stream (replay via ?since=<seq>)
+      operationId: sessionEvents
+      parameters:
+        - name: sessionId
+          in: path
+          required: true
+          schema: { type: string }
+        - name: since
+          in: query
+          schema: { type: integer }
+      responses:
+        "200":
+          description: text/event-stream of framework events
+          content:
+            text/event-stream:
+              schema:
+                type: object
+components:
+  schemas:
+    SessionInfo:
+      type: object
+      required: [id, workspaceId, userId, title, agent, model, permission, queuedPrompts, time]
+      properties:
+        id: { type: string }
+        workspaceId: { type: string }
+        userId: { type: string }
+        parentId: { type: string }
+        title: { type: string }
+        agent: { type: string }
+        model:
+          type: object
+          properties:
+            providerId: { type: string }
+            modelId: { type: string }
+        permission:
+          type: array
+          items:
+            type: object
+            properties:
+              permission: { type: string }
+              pattern: { type: string }
+              action: { type: string, enum: [allow, deny, ask] }
+        queuedPrompts:
+          type: array
+          items:
+            type: object
+            properties:
+              text: { type: string }
+              agent: { type: string }
+              enqueuedAt: { type: string }
+        time:
+          type: object
+          properties:
+            created: { type: string }
+            updated: { type: string }
+    MessageInfo:
+      type: object
+      required: [id, sessionId, role, agent, model, time]
+      properties:
+        id: { type: string }
+        sessionId: { type: string }
+        role: { type: string, enum: [user, assistant] }
+        parentId: { type: string }
+        agent: { type: string }
+        model: { type: object }
+        tokens: { type: object }
+        error: { type: object }
+        time: { type: object }
+    Part:
+      type: object
+      required: [id, sessionId, messageId, type]
+      properties:
+        id: { type: string }
+        sessionId: { type: string }
+        messageId: { type: string }
+        type: { type: string, enum: [text, reasoning, tool, step-start, step-finish, subtask, file, compaction] }
+        text: { type: string }
+        callId: { type: string }
+        tool: { type: string }
+        state: { type: object }
+        summary: { type: string }
+        childSessionId: { type: string }
+    PermissionRequest:
+      type: object
+      properties:
+        id: { type: string }
+        sessionId: { type: string }
+        permission: { type: string }
+        patterns: { type: array, items: { type: string } }
+        metadata: { type: object }
+        always: { type: array, items: { type: string } }
+        tool: { type: object }

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@zmzai/agent-framework",
+  "version": "0.1.0",
+  "description": "PI-based agent framework — sessions, permissions, tools, runner, events (OpenCode-style).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "zmzai-agent": "./dist/cli.js"
+  },
+  "files": ["dist", "openapi.yaml"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@earendil-works/pi-agent-core": "0.84.1",
+    "@earendil-works/pi-ai": "0.84.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "vitest": "^4.1.10"
+  }
+}