@plico-ai/runtime 0.0.0-reserved.0 → 0.1.0

package/dist/types/provider.js

@@ -0,0 +1 @@
+export {};

package/dist/types/readiness.d.ts

@@ -0,0 +1,9 @@
+import type { ThreadStore } from "../storage/sqlite/threads.js";
+import type { EventStore } from "./store.js";
+export interface ReadinessOptions {
+    databasePath?: string;
+    eventStore?: EventStore;
+    threadStore?: Pick<ThreadStore, "storageIdentity">;
+    /** Built Studio directory. Omit when Studio is not in use. */
+    studioPath?: string | undefined;
+}

package/dist/types/readiness.js

@@ -0,0 +1 @@
+export {};

package/dist/types/run.d.ts

@@ -0,0 +1,28 @@
+import type { JsonValue } from "@plico-ai/contracts";
+import type { Engine } from "../engine/index.js";
+import type { ModelProvider, ProviderMessage } from "./provider.js";
+import type { DryRunScriptStep } from "./script.js";
+import type { EventStore } from "./store.js";
+export interface RunProjectOptions {
+    script?: DryRunScriptStep[];
+    /**
+     * Do not run tool handlers for scripted `tool.call` steps. Each step supplies its output as
+     * `result`; a step without one fails the run, and `live: true` opts a step back in to its handler.
+     */
+    mockTools?: boolean;
+    eventStore?: EventStore;
+    /** Runs the loop durably. Defaults to an in-memory engine that does not survive the process. */
+    engine?: Engine;
+    runId?: string;
+    provider?: ModelProvider;
+    /** Opaque identity used to prevent recovery with a different provider configuration. */
+    providerRecoveryKey?: string;
+    message?: string;
+    threadId?: string;
+    /** Host data stamped on `run.started`. Immutable and returned by run reads and filters. */
+    metadata?: Record<string, JsonValue>;
+    /** Host data passed to tools as `ctx.context` and recorded on `run.started`. No secrets. */
+    context?: Record<string, JsonValue>;
+    history?: Array<Pick<ProviderMessage, "role" | "content">>;
+    onStarted?: (runId: string) => void;
+}

package/dist/types/run.js

@@ -0,0 +1 @@
+export {};

package/dist/types/script.d.ts

@@ -0,0 +1,16 @@
+import type { ArtifactFileInput } from "./artifacts.js";
+export type DryRunScriptStep = {
+    type: "assistant.output";
+    content: string;
+} | {
+    type: "tool.call";
+    toolName: string;
+    arguments: unknown;
+    /** The output to use instead of running the tool, when the run mocks tools. */
+    result?: unknown;
+    /** Run the real handler even when the run mocks tools. */
+    live?: true;
+} | {
+    type: "artifact.write";
+    files: ArtifactFileInput[];
+};

package/dist/types/script.js

@@ -0,0 +1 @@
+export {};

package/dist/types/store.d.ts

@@ -0,0 +1,24 @@
+import type { EvalReport, JsonValue, PlicoEvent, RunSummary } from "@plico-ai/contracts";
+export interface EventStore {
+    readonly storageIdentity?: string;
+    appendEvent(event: PlicoEvent): Promise<void>;
+    /** Lists runs, newest first. `metadata` keeps runs whose top-level keys equal every given value. */
+    listRuns(filter?: {
+        metadata?: Record<string, JsonValue>;
+    }): Promise<RunSummary[]>;
+    getRun(runId: string): Promise<RunSummary | undefined>;
+    getEvents(runId: string, options?: {
+        afterSequence?: number;
+    }): Promise<PlicoEvent[]>;
+    /** Returns run events in a thread, ordered by their durable insertion order. */
+    getThreadRunEvents?(threadId: string): Promise<PlicoEvent[]>;
+    /** Returns thread run events through the selected run's final durable position. */
+    getThreadRunEventsThrough?(threadId: string, runId: string): Promise<PlicoEvent[]>;
+    persistEvalReport(report: EvalReport): Promise<void>;
+    getLatestEvalReport(): Promise<EvalReport | undefined>;
+}
+export interface CreateSqliteEventStoreOptions {
+    databasePath: string;
+    /** Open an existing database without changing it. Adds no files unless it has a pending WAL. */
+    readOnly?: boolean;
+}

package/dist/types/store.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tools.d.ts

@@ -0,0 +1,15 @@
+import type { JsonSchema, ToolDefinition } from "@plico-ai/contracts";
+export type { JsonSchema, JsonSchemaObject, ToolApprovalPolicy, ToolArtifactContext, ToolArtifactFile, ToolDefinition, ToolHandlerContext, ToolInputSchema, ZodInputParseResult, ZodInputSchema, } from "@plico-ai/contracts";
+export type ToolInputParseResult = {
+    success: true;
+    value: unknown;
+} | {
+    success: false;
+    error: string;
+};
+export interface DeclaredTool extends Omit<ToolDefinition, "inputSchema"> {
+    source: string;
+    inputSchema: JsonSchema;
+    validateInput(input: unknown): Promise<string | undefined>;
+    parseInput(input: unknown): Promise<ToolInputParseResult>;
+}

package/dist/types/tools.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,21 +1,80 @@
 {
   "name": "@plico-ai/runtime",
-  "version": "0.0.0-reserved.0",
-  "description": "The Plico run engine, event log and tools. Not released yet.",
+  "version": "0.1.0",
+  "description": "Plico runtime: linear agent runs, durable event log, tools, evals and readiness checks",
   "license": "Apache-2.0",
   "homepage": "https://plico.sohab.dev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ITZSHOAIB/plico.git"
+    "url": "git+https://github.com/ITZSHOAIB/plico.git",
+    "directory": "packages/runtime"
   },
   "keywords": [
     "plico",
-    "agent"
-  ],
-  "files": [
-    "README.md"
+    "agent",
+    "runtime",
+    "evals"
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "NOTICE",
+    "dist"
+  ],
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "^3.0.84",
+    "@opentelemetry/api": "1.9.0",
+    "ai": "^7.0.162",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "mime": "4.1.2",
+    "picomatch": "4.0.4",
+    "tsx": "4.22.4",
+    "zod-to-json-schema": "3.25.2",
+    "@plico-ai/contracts": "0.1.0",
+    "@plico-ai/core": "0.1.0"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^4.0.99",
+    "@ai-sdk/google": "^4.0.114",
+    "@ai-sdk/openai": "^4.0.111",
+    "@opentelemetry/context-async-hooks": "2.0.1",
+    "@opentelemetry/sdk-trace-base": "2.0.1",
+    "@types/picomatch": "^4.0.3",
+    "zod": "3.25.76"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^4.0.99",
+    "@ai-sdk/google": "^4.0.114",
+    "@ai-sdk/openai": "^4.0.111"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
+    "test": "vitest run"
   }
-}
+}