@providerprotocol/agents 0.0.2 → 0.0.4

package/dist/types-DChRdQoX.d.ts

@@ -0,0 +1,98 @@
+import { a as AgentStateJSON } from './types-2Vsthzyu.js';
+
+/**
+ * Checkpoint Types
+ *
+ * Type definitions for step-level persistence and session resume.
+ *
+ * @see UAP-1.0 Spec Section 12.4
+ */
+
+/**
+ * Checkpoint store interface.
+ *
+ * Implementations handle persistence of agent state at step boundaries
+ * for crash recovery and session resume.
+ *
+ * @example
+ * ```typescript
+ * const store = fileCheckpoints({ dir: './checkpoints' });
+ *
+ * // Save checkpoint
+ * await store.save('session-123', state.toJSON());
+ *
+ * // Load checkpoint
+ * const saved = await store.load('session-123');
+ * if (saved) {
+ *   const restored = AgentState.fromJSON(saved);
+ * }
+ * ```
+ */
+interface CheckpointStore {
+    /**
+     * Save a checkpoint at the current state.
+     *
+     * @param sessionId - Session identifier
+     * @param state - Serialized agent state
+     */
+    save(sessionId: string, state: AgentStateJSON): Promise<void>;
+    /**
+     * Load the most recent checkpoint for a session.
+     *
+     * @param sessionId - Session identifier
+     * @returns Serialized state or null if not found
+     */
+    load(sessionId: string): Promise<AgentStateJSON | null>;
+    /**
+     * Load metadata for a session without loading full state.
+     *
+     * @param sessionId - Session identifier
+     * @returns Checkpoint metadata or null if not found
+     */
+    loadMetadata(sessionId: string): Promise<CheckpointMetadata | null>;
+    /**
+     * Delete all checkpoints for a session.
+     *
+     * @param sessionId - Session identifier
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * List all session IDs with checkpoints.
+     *
+     * @returns Array of session IDs
+     */
+    list(): Promise<string[]>;
+}
+/**
+ * Options for file-based checkpoint store.
+ */
+interface FileCheckpointOptions {
+    /** Directory for checkpoint files. Default: ".checkpoints" */
+    dir?: string;
+}
+/**
+ * Checkpoint metadata stored alongside state.
+ */
+interface CheckpointMetadata {
+    /** Session identifier */
+    sessionId: string;
+    /** Unique checkpoint ID */
+    checkpointId: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Step number at checkpoint */
+    step: number;
+    /** Agent instance ID */
+    agentId: string;
+}
+/**
+ * Full checkpoint data including state and metadata.
+ */
+interface CheckpointData {
+    /** Checkpoint metadata */
+    metadata: CheckpointMetadata;
+    /** Serialized agent state */
+    state: AgentStateJSON;
+}
+
+export type { CheckpointStore as C, FileCheckpointOptions as F, CheckpointMetadata as a, CheckpointData as b };

package/package.json

@@ -1,21 +1,52 @@
 {
   "name": "@providerprotocol/agents",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Unified Agent Protocol (UAP) 1.0 implementation for @providerprotocol/ai",
   "type": "module",
   "author": {
     "name": "Provider Protocol"
   },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/providerprotocol/agents"
+  },
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./execution": "./src/execution/index.ts",
-    "./middleware": "./src/middleware/index.ts",
-    "./thread-tree": "./src/thread-tree/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./execution": {
+      "types": "./dist/execution/index.d.ts",
+      "import": "./dist/execution/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js"
+    },
+    "./thread-tree": {
+      "types": "./dist/thread-tree/index.d.ts",
+      "import": "./dist/thread-tree/index.js"
+    },
+    "./checkpoint": {
+      "types": "./dist/checkpoint/index.d.ts",
+      "import": "./dist/checkpoint/index.js"
+    }
   },
   "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "bun run build",
     "test": "bun test",
     "test:unit": "bun test tests/unit",
     "test:live": "bun test tests/live",
@@ -23,15 +54,16 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@providerprotocol/ai": ">=0.0.11",
-    "typescript": "^5.9.3"
+    "@providerprotocol/ai": ">=0.0.11"
   },
   "devDependencies": {
-    "@providerprotocol/ai": "^0.0.11",
+    "@providerprotocol/ai": "^0.0.12",
     "@types/bun": "^1.3.5",
     "@typescript-eslint/eslint-plugin": "^8.52.0",
     "@typescript-eslint/parser": "^8.52.0",
     "eslint": "^9.39.2",
-    "eslint-plugin-import": "^2.32.0"
+    "eslint-plugin-import": "^2.32.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
   }
 }

package/.claude/settings.local.json

@@ -1,29 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(tree:*)",
-      "Bash(bun test:*)",
-      "Bash(bun run typecheck:*)",
-      "Bash(bun run lint)",
-      "Bash(ls:*)",
-      "Bash(cat:*)",
-      "Bash(find:*)",
-      "Bash(bun test:live:*)",
-      "WebSearch",
-      "WebFetch(domain:arxiv.org)",
-      "WebFetch(domain:www.microsoft.com)",
-      "WebFetch(domain:docs.anthropic.com)",
-      "WebFetch(domain:blog.jetbrains.com)",
-      "Bash(grep:*)",
-      "Bash(bun install:*)",
-      "Bash(bun update:*)",
-      "Bash(timeout 2 bun:*)",
-      "WebFetch(domain:www.npmjs.com)",
-      "WebFetch(domain:github.com)",
-      "WebFetch(domain:raw.githubusercontent.com)",
-      "Bash(bun add:*)",
-      "Bash(timeout 3 bun run:*)",
-      "Bash(bun -e:*)"
-    ]
-  }
-}