maestro-agent-sdk 0.1.4 → 0.1.6

package/README.md

@@ -15,17 +15,18 @@ Inspired by [Claude Code](https://www.anthropic.com/claude-code) and [`hermes-ag
 
 | | What you get |
 |---|---|
-| **vs [`@anthropic-ai/claude-agent-sdk`](https://github.com/anthropics/claude-agent-sdk-typescript)** | Multi-provider from day one (Anthropic + DeepSeek), with skills (`SKILL.md` indexing), memory (auto context compaction), and MCP client pool built in — not provided as separate add-ons. |
+| **vs [`@anthropic-ai/claude-agent-sdk`](https://github.com/anthropics/claude-agent-sdk-typescript)** | Multi-provider from day one (Anthropic + DeepSeek), with skills (`SKILL.md` / `skill.md` indexing), memory (auto context compaction), and MCP client pool built in — not provided as separate add-ons. |
 | **vs LangChain / LangGraph** | Thin loop, no DSL. A provider is one adapter file; a tool is `{ name, description, schema, run }`. You read the source in an afternoon. |
 
 ## What's in the box
 
 - **Agent loop** — provider-driven tool-calling loop with iteration cap, abort signal, and event stream.
 - **Pluggable providers** — first-class adapters for Anthropic (Claude) and DeepSeek V4; provider-neutral message schema so adding OpenAI / Gemini / Ollama is a thin file.
-- **Built-in tools** — `bash`, `read`, `write`, `edit`, `agent` (sub-agent delegation), `todo_write`, `skill_view`, `web_fetch`. Bring your own via `ToolRegistry`.
+- **Built-in tools** — `bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `Agent` (sub-agent delegation), `TaskCreate`/`TaskUpdate`/`TaskList`/`TaskGet`, `WebFetch`, `skill_view`, `skill_write`. Bring your own via `ToolRegistry`. Grep shells out to ripgrep (`rg`) so install it if you want the tool active; the SDK surfaces a structured error pointing to the install path when missing.
 - **MCP** — built-in client pool (stdio + SSE) so any MCP server (`@modelcontextprotocol/sdk`) shows up as tools.
-- **Skills** — Anthropic-style `SKILL.md` packages with FTS-style indexing and on-demand expansion.
+- **Skills** — per-workspace `.skills/<skillKey>/<name>/skill.md` packages with FTS-style indexing, on-demand body load (`skill_view`), and agent-autonomous authoring (`skill_write`).
 - **Memory** — automatic context compression (summarization + pruning) when the token budget is hit. Reuses the agent's own model for compaction — no separate model knob.
+- **Session persistence** — multi-turn resume via `~/.maestro/sessions/<sessionId>.jsonl`, with a `_meta` header capturing `cwd`, `skillKey`, `userId`, and host metadata for forensics.
 - **Host integration via DI** — `setLogger`, `setMcpResolver`, `setConversationReader` let you embed without inheriting any one host's opinions. FS policy (path allowlists, owner checks) is a host concern — register a `PreToolUseHook` via `ToolRegistry.use()`.
 
 ## Install
@@ -119,22 +120,143 @@ for await (const event of runConversation(agent, "Summarize today's news.")) {
 > | `max`   |         65 536  |           200 |
 
 More runnable scripts live under [`examples/`](./examples) — Anthropic, DeepSeek,
-and a custom-tool walkthrough.
+a custom-tool walkthrough, and a `skill_write` demo.
+
+## Skills — per-workspace, agent-autonomous
+
+Skill catalog routing is deterministic from `(opts.cwd, opts.skillKey)`:
+
+```
+  skillKey set    → <cwd>/.skills/<skillKey>/
+  skillKey unset  → <cwd>/.skills/default/   (uses MAESTRO_DEFAULT_SKILL_KEY)
+```
+
+Every skill lives under a **named key** subdirectory. The SDK never reads from
+`<cwd>/.skills/` directly, so a host can list "which profiles exist in this
+workspace?" with one `readdir`. One workspace can host multiple disjoint
+catalogs (e.g. `legal/`, `coding/`, `research/`) and each session selects its
+profile by passing `skillKey`.
+
+### On-disk layout
+
+```
+<cwd>/.skills/
+├── default/                          ← skillKey omitted
+│   └── general/note-template/skill.md
+├── legal/                            ← skillKey: "legal"
+│   └── general/
+│       ├── ocr/
+│       │   ├── skill.md
+│       │   ├── scripts/preprocess.py
+│       │   └── references/api.md
+│       └── hearing-report/skill.md
+└── coding/                           ← skillKey: "coding"
+    └── general/code-review/skill.md
+```
+
+### Manifest format (clawgram-style)
+
+Two filename conventions are accepted: `SKILL.md` (upstream v0.13.0 with YAML
+frontmatter) and `skill.md` (lowercase, body-based). For new skills the
+clawgram convention is recommended:
+
+```markdown
+# OCR 텍스트 추출 (English subtitle)
+
+> **Description**: OCR, 이미지 읽어줘, PDF 텍스트 추출 요청 시 트리거.
+
+## Required MCP
+- ocr
+- paddleocr
+
+## 트리거
+- ...
+
+## 프로세스
+### 1. 이미지 준비
+### 2. paddleocr 실행
+
+## Gotchas
+- 흐릿한 이미지는 deskew 필요
+```
+
+The first heading is the display title; the `> **Description**: ...` blockquote
+carries the trigger keywords (this drives system-prompt activation). The
+loader extracts the description from either YAML frontmatter or this
+blockquote — both styles can coexist in the same `.skills/<key>/` tree.
+
+### Authoring from inside the agent — `skill_write`
+
+The model can persist new skills mid-session, including adjacent assets
+(scripts, templates, references), in one transactional call:
+
+```ts
+skill_write({
+  name: "ocr",                       // kebab-case, becomes the folder name
+  content: "# OCR ...\n\n> **Description**: OCR, 이미지 읽어줘\n\n...",
+  files: {
+    "scripts/preprocess.py": "import cv2\n...",
+    "scripts/run.sh": "#!/bin/bash\n...",
+    "templates/report.html": "<!doctype html>...",
+    "references/paddleocr-api.md": "# PaddleOCR API\n...",
+  },
+  overwrite: false,                  // default: refuse to clobber
+});
+```
+
+Resulting layout under `<skillsDir>/ocr/`:
+
+```
+ocr/
+├── skill.md            ← from `content`
+├── scripts/
+│   ├── preprocess.py
+│   └── run.sh
+├── templates/report.html
+└── references/paddleocr-api.md
+```
+
+Safety:
+
+- kebab-case validation on `name`
+- relative-path validation on every `files` key (rejects `..` escapes,
+  absolute prefixes, backslashes, and the reserved `skill.md` name)
+- `overwrite=false` → batch aborts BEFORE any disk touch if any target
+  already exists (validate-all-then-write)
+- cache invalidation on success → the new skill appears in the NEXT turn's
+  `<available_skills>` catalog (intentionally not the current turn — would
+  break the prompt cache)
+
+### Reading from the model side — `skill_view`
+
+The system prompt only carries name + summary per skill (FTS-style index).
+When the model decides a skill is relevant it calls `skill_view(name)` and
+gets the full body back, with a `[Skill directory: ...]` hint so relative
+paths in the body resolve against the right cwd.
 
 ## Configuration
 
+Per-call options on `AgentQueryOptions`:
+
+| Option | Required | Purpose |
+|---|---|---|
+| `cwd` | ✓ | Workspace root. Drives `.skills/` location, rollout `_meta`, and the `mkdir` invariant. |
+| `skillKey` | — | Named skill profile within `<cwd>/.skills/`. Omit for `default`. |
+| `allowedSkills` | — | Per-call name whitelist applied before curation. |
+| `sessionMetadata` | — | Opaque host bag round-tripped via the rollout `_meta` header. |
+
 The SDK resolves its data directory at module load. Override via env var
 **before** importing any SDK module (the value is captured once):
 
 | Env var | Default | What it does |
 |---|---|---|
-| `MAESTRO_DATA_DIR` | `~/.maestro` | Where session JSONLs, skill usage counters, and todo stores live. `maestroSessionsDir()` resolves to `<DATA_DIR>/sessions`. |
+| `MAESTRO_DATA_DIR` | `~/.maestro` | Where session JSONLs and todo stores live. `maestroSessionsDir()` resolves to `<DATA_DIR>/sessions`. |
 
 Everything else is per-call: pass `cwd`, `model`, `effort`, etc. through
 `AIAgentConfig` / `AgentQueryOptions`. The memory compressor reuses the
 agent's configured `model` — no separate compression-model knob.
 
-For session housekeeping there's a helper that hosts can wire into their
+For session housekeeping there's a helper hosts can wire into their
 startup sweep:
 
 ```ts
@@ -145,6 +267,71 @@ const { scanned, removed } = cleanupStaleMaestroSessions();
 console.log(`maestro sweep: removed ${removed}/${scanned}`);
 ```
 
+## Tasks — granular CRUD via Claude-Code-style `Task*` family
+
+v0.1.5 replaced the v0.1.x `TodoWrite` snapshot-replace tool with the
+`Task*` family — `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet`. The
+trade-off: per-call payloads are smaller (one task at a time vs the whole
+list every turn) and the model gets first-class dependency edges and
+per-task metadata.
+
+```ts
+// Bootstrap a multi-step plan.
+TaskCreate({ subject: "Read spec", activeForm: "Reading spec" });
+// → { ok: true, id: "1", subject: "Read spec" }
+
+TaskCreate({ subject: "Implement loader" });
+// → { ok: true, id: "2" }
+
+TaskCreate({ subject: "Write tests", owner: "general" });
+// → { ok: true, id: "3" }
+
+// Wire dependencies. Both sides update in sync.
+TaskUpdate({ taskId: "3", addBlockedBy: ["2"] });
+
+// Advance status. Setting in_progress demotes any other in-flight task.
+TaskUpdate({ taskId: "1", status: "in_progress" });
+TaskUpdate({ taskId: "1", status: "completed" });
+TaskUpdate({ taskId: "2", status: "in_progress" });
+// → { ok: true, task: {...}, demotedId: "1" }  // (was already completed, no-op)
+
+// Read side — the per-turn system reminder already renders a summary;
+// TaskList exists for programmatic refresh after batch updates.
+TaskList();
+// TaskGet({ taskId: "2" }) for the full entry with description + metadata.
+```
+
+Persistence: `~/.maestro/sessions/<sessionId>.tasks.json` (`version: 2`).
+Files written by SDK ≤ 0.1.4 land at `.todos.json` (`version: 1`); the
+v0.1.5 store auto-migrates on first hydrate so existing sessions keep their
+plan without manual conversion. The migration strips the `task-N` prefix
+to bare numeric ids and maps `content` → `subject`.
+
+The system reminder rendered every turn carries a compact view:
+
+```
+Tasks (1/3):
+  [✓] #1  Read spec
+  [→] #2  Implement loader
+  [ ] #3  Write tests (blocked by #2)
+```
+
+## Session rollout format (since v0.1.5)
+
+Each session JSONL at `~/.maestro/sessions/<sessionId>.jsonl` carries a
+`_meta` header line for forensics and host-side indexing:
+
+```jsonl
+{"_meta":{"version":1,"cwd":"/path","skillKey":"legal","userId":"...","createdAt":"2026-05-18T...","sdkVersion":"0.1.5","skillsDir":"...","metadata":{...}}}
+{"role":"user","content":"..."}
+{"role":"assistant","content":[...]}
+```
+
+Backward-compatible: files written by SDK ≤ 0.1.4 had no header — the loader
+treats their first line as a regular message. Hosts that want to inspect
+session metadata without reading the full message log can call
+`loadMaestroSessionMeta(sessionId)`.
+
 ## Architecture
 
 ```
@@ -153,11 +340,11 @@ src/
 ├── tools/        ToolRegistry + builtin tools + PreToolUse/PostToolUse hook surface
 ├── providers/    Provider adapters (anthropic, deepseek)
 ├── mcp/          MCP client pool (stdio + SSE)
-├── skills/       SKILL.md loader, index builder, usage tracker, curator
+├── skills/       Skill loader, index builder, usage tracker, curator
 ├── memory/       Context compressor, token estimator, reminders, scrubber
 ├── state/        Per-session todo store
-├── sub-agent/    Sub-agent runner for the `agent` tool
-├── platform/     Injectable host adapters (logger, lifecycle, config, jsonl, mcp-config)
+├── sub-agent/    Sub-agent runner for the `Agent` tool
+├── platform/     Injectable host adapters (logger, lifecycle, config, jsonl, version, mcp-config)
 ├── agents/       Cross-agent rollout helpers + per-agent registry contract
 ├── storage/      ConversationReader DI (host supplies past turns for cross-agent forks)
 └── media/        File-event extraction from inline `[FILE:/path]` tags
@@ -195,7 +382,7 @@ cd maestro-agent-sdk
 npm install
 npm run typecheck   # tsc --noEmit
 npm run build       # tsc + tsc-alias → dist/
-npm test            # vitest, 330 tests
+npm test            # vitest, 426 tests (+11 skipped without ripgrep)
 ```
 
 ### Known gaps

package/dist/agents/contracts.d.ts

@@ -12,6 +12,16 @@ export interface WriteRolloutOptions {
     cwd: string;
     entries: ConversationEntry[];
     reuseSessionId?: string;
+    /** Optional host-side identifier carried into the rollout `_meta` header
+     *  (since v0.1.5). Hosts that orchestrate multiple users can pass their
+     *  user id here so a later sweep can attribute the JSONL without opening
+     *  the conversation log it was synthesized from. */
+    userId?: string;
+    /** Opaque host-supplied bag persisted with the rollout. The registry
+     *  passes it through to `writeMaestroRollout` verbatim; the SDK never
+     *  reads the shape. Useful for `topicId`, `groupId`, or any other host
+     *  identifier the meta header should round-trip. */
+    metadata?: Record<string, unknown>;
 }
 export interface WriteRolloutResult {
     sessionId: string;

package/dist/agents/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/agents/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;GAOG;AAEH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IACxC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACzD,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,CAAC;IAC5D,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpE,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/agents/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;;;;GAOG;AAEH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;wDAGoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;wDAGoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IACxC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACzD,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,CAAC;IAC5D,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpE,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  *
  * Originally derived from Nous Research's hermes-agent (MIT); see NOTICE.
  */
-export declare const MAESTRO_SDK_VERSION: "0.1.4";
+export { MAESTRO_SDK_VERSION } from "./platform/version.js";
 export declare const MAESTRO_UPSTREAM_SNAPSHOT: "v0.13.0 (2026-05-07)";
 export { AIAgent, type AIAgentConfig } from "./core/agent.js";
 export { runConversation } from "./core/loop.js";
@@ -15,15 +15,18 @@ export { bashTool } from "./tools/builtin/bash.js";
 export { createReadTool } from "./tools/builtin/read.js";
 export { createWriteTool } from "./tools/builtin/write.js";
 export { createEditTool } from "./tools/builtin/edit.js";
-export { createTodoWriteTool } from "./tools/builtin/todo_write.js";
+export { globTool, compileGlob } from "./tools/builtin/glob.js";
+export { grepTool } from "./tools/builtin/grep.js";
+export { createTaskCreateTool, createTaskUpdateTool, createTaskListTool, createTaskGetTool, } from "./tools/builtin/tasks.js";
 export { createSkillViewTool } from "./tools/builtin/skill_view.js";
+export { createSkillWriteTool } from "./tools/builtin/skill_write.js";
 export { createAgentTool } from "./tools/builtin/agent.js";
 export { getFileStateTracker, dropFileStateTracker } from "./tools/file-state.js";
 export type { Provider, ProviderToolSchema, ProviderMessage, ProviderContentBlock, ProviderResponse, ProviderStreamChunk, ProviderCompleteOptions, } from "./providers/base.js";
 export { AnthropicProvider, effortToThinkingBudget, effortToMaxIter, applyThinkingBudget, buildCacheableSystem, buildCacheableTools, buildCacheableMessages, } from "./providers/anthropic.js";
 export { DeepseekProvider, effortForDeepseek, translateToolsToOpenAI, translateMessagesToOpenAI, } from "./providers/deepseek.js";
 export { maestroRegistry } from "./registry.js";
-export { maestroProvider, providerForModel, isAbortError, iterationBudgetLine } from "./provider.js";
+export { maestroProvider, providerForModel, isAbortError, iterationBudgetLine, resolveSkillsDir, applySkillAllowlist, MAESTRO_DEFAULT_SKILL_KEY, } from "./provider.js";
 export { loadSkillsCached, findSkillByName, type SkillEntry } from "./skills/loader.js";
 export { buildSkillsIndex } from "./skills/index-builder.js";
 export { curateSkills } from "./skills/curator.js";
@@ -33,14 +36,14 @@ export { estimateTokens } from "./memory/token-estimate.js";
 export { buildSystemReminder } from "./memory/reminder.js";
 export { hashToolContent } from "./memory/hash.js";
 export { ACTIVE_TASK_TEMPLATE, wrapCompactedSummary } from "./memory/active-task-template.js";
-export { getTodoStore, dropTodoStore } from "./state/todos.js";
+export { getTaskStore, dropTaskStore, type TaskEntry, type TaskStatus } from "./state/tasks.js";
 export type { MaestroMcpServerSpec, MaestroMcpClient, MaestroMcpTool } from "./mcp/client.js";
-export { deleteMaestroSession, maestroSessionsDir, cleanupStaleMaestroSessions, DEFAULT_MAESTRO_SESSION_TTL_MS, } from "./session-store.js";
+export { deleteMaestroSession, maestroSessionsDir, cleanupStaleMaestroSessions, DEFAULT_MAESTRO_SESSION_TTL_MS, loadMaestroSessionMeta, type MaestroSessionMeta, } from "./session-store.js";
 export { setLogger, type Logger, type LogFn } from "./platform/logger.js";
 export { onShutdown, runShutdown } from "./platform/lifecycle.js";
 export { setMcpResolver, type McpResolver, type McpServerMap } from "./platform/mcp-config.js";
 export { setConversationReader, type ConversationReader } from "./storage/conversations.js";
-export type { TokenUsage, EffortLevel, AgentKind, AgentQueryOptions, UnifiedEvent, } from "./types.js";
+export type { TokenUsage, EffortLevel, AgentKind, AgentHooks, AgentQueryOptions, UnifiedEvent, } from "./types.js";
 export { MAESTRO_EFFORT_VALUES, SUPPORTED_AGENTS, FALLBACK_AGENT, isAgentKind, } from "./types.js";
 export type { ConversationEntry } from "./storage/conversations.js";
 export type { AgentRegistry, WriteRolloutOptions, WriteRolloutResult, ForkRegistryOptions, ForkRegistryResult, CleanupRolloutsOptions, } from "./agents/contracts.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -6,7 +6,7 @@
  *
  * Originally derived from Nous Research's hermes-agent (MIT); see NOTICE.
  */
-export const MAESTRO_SDK_VERSION = "0.1.4";
+export { MAESTRO_SDK_VERSION } from "./platform/version.js";
 export const MAESTRO_UPSTREAM_SNAPSHOT = "v0.13.0 (2026-05-07)";
 // ─── Core agent loop ─────────────────────────────────────────────────────────
 export { AIAgent } from "./core/agent.js";
@@ -18,15 +18,18 @@ export { bashTool } from "./tools/builtin/bash.js";
 export { createReadTool } from "./tools/builtin/read.js";
 export { createWriteTool } from "./tools/builtin/write.js";
 export { createEditTool } from "./tools/builtin/edit.js";
-export { createTodoWriteTool } from "./tools/builtin/todo_write.js";
+export { globTool, compileGlob } from "./tools/builtin/glob.js";
+export { grepTool } from "./tools/builtin/grep.js";
+export { createTaskCreateTool, createTaskUpdateTool, createTaskListTool, createTaskGetTool, } from "./tools/builtin/tasks.js";
 export { createSkillViewTool } from "./tools/builtin/skill_view.js";
+export { createSkillWriteTool } from "./tools/builtin/skill_write.js";
 export { createAgentTool } from "./tools/builtin/agent.js";
 export { getFileStateTracker, dropFileStateTracker } from "./tools/file-state.js";
 export { AnthropicProvider, effortToThinkingBudget, effortToMaxIter, applyThinkingBudget, buildCacheableSystem, buildCacheableTools, buildCacheableMessages, } from "./providers/anthropic.js";
 export { DeepseekProvider, effortForDeepseek, translateToolsToOpenAI, translateMessagesToOpenAI, } from "./providers/deepseek.js";
 // ─── Maestro registry + top-level provider entry point ───────────────────────
 export { maestroRegistry } from "./registry.js";
-export { maestroProvider, providerForModel, isAbortError, iterationBudgetLine } from "./provider.js";
+export { maestroProvider, providerForModel, isAbortError, iterationBudgetLine, resolveSkillsDir, applySkillAllowlist, MAESTRO_DEFAULT_SKILL_KEY, } from "./provider.js";
 // ─── Skills ──────────────────────────────────────────────────────────────────
 export { loadSkillsCached, findSkillByName } from "./skills/loader.js";
 export { buildSkillsIndex } from "./skills/index-builder.js";
@@ -39,9 +42,9 @@ export { buildSystemReminder } from "./memory/reminder.js";
 export { hashToolContent } from "./memory/hash.js";
 export { ACTIVE_TASK_TEMPLATE, wrapCompactedSummary } from "./memory/active-task-template.js";
 // ─── State (todos) ───────────────────────────────────────────────────────────
-export { getTodoStore, dropTodoStore } from "./state/todos.js";
+export { getTaskStore, dropTaskStore } from "./state/tasks.js";
 // ─── Session store ───────────────────────────────────────────────────────────
-export { deleteMaestroSession, maestroSessionsDir, cleanupStaleMaestroSessions, DEFAULT_MAESTRO_SESSION_TTL_MS, } from "./session-store.js";
+export { deleteMaestroSession, maestroSessionsDir, cleanupStaleMaestroSessions, DEFAULT_MAESTRO_SESSION_TTL_MS, loadMaestroSessionMeta, } from "./session-store.js";
 // ─── Host integration points (dependency injection) ──────────────────────────
 export { setLogger } from "./platform/logger.js";
 export { onShutdown, runShutdown } from "./platform/lifecycle.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAA+B,CAAC;AAEzE,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAsB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,gFAAgF;AAChF,OAAO,EACL,YAAY,GASb,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAa/E,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAE9B,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAElG,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAmB,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAsB,MAAM,gBAAgB,CAAC;AAEzE,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE3F,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK5D,gFAAgF;AAChF,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAA2B,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAuC,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAA2B,MAAM,yBAAyB,CAAC;AAUzF,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/memory/reminder.d.ts

@@ -1,11 +1,11 @@
-import type { TodoEntry } from "../state/todos.js";
+import type { TaskEntry } from "../state/tasks.js";
 /**
  * System-reminder builder.
  *
  * Renders the `<system-reminder>…</system-reminder>` block that gets
  * attached to every new user message in `maestroProvider`. The reminder
  * carries invariants the model needs to keep in mind for the current turn
- * — session id, todo list, caller-supplied extras — and is what keeps long
+ * — session id, task list, caller-supplied extras — and is what keeps long
  * sessions from forgetting the rules after the compactor evicts the middle.
  *
  * Why this lives outside `loop.ts`:
@@ -32,12 +32,13 @@ export interface SystemReminderContext {
      */
     sessionId: string;
     /**
-     * Current TodoWrite list snapshot. When non-empty, the reminder renders
-     * a compact status header so the model carries the plan across turns
-     * without having to call a read-side tool. The list is the read-side —
-     * `todo_write` is the only related tool the model sees.
+     * Current task list snapshot (non-deleted entries). When non-empty, the
+     * reminder renders a compact status header so the model carries the plan
+     * across turns without having to call TaskList. TaskList exists for
+     * programmatic refresh after large batches; the reminder is the always-on
+     * read path.
      */
-    todos?: readonly TodoEntry[];
+    tasks?: readonly TaskEntry[];
     /**
      * Anything additional the caller wants to render verbatim. Each entry
      * becomes one line at the tail of the reminder. Caller owns formatting.
@@ -49,8 +50,7 @@ export interface SystemReminderContext {
  * callers attach verbatim as a `text` content block on a user message.
  *
  * Empty extras renders to ~2 lines so the per-turn token cost is bounded;
- * the catalog of facts only grows as later phases add semantic state
- * (Phase 3.2 task list, etc.).
+ * the catalog of facts only grows as later phases add semantic state.
  */
 export declare function buildSystemReminder(ctx: SystemReminderContext): string;
 //# sourceMappingURL=reminder.d.ts.map

package/dist/memory/reminder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reminder.d.ts","sourceRoot":"","sources":["../../src/memory/reminder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CA8BtE"}
+{"version":3,"file":"reminder.d.ts","sourceRoot":"","sources":["../../src/memory/reminder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAuCtE"}

package/dist/memory/reminder.js

@@ -3,26 +3,32 @@
  * callers attach verbatim as a `text` content block on a user message.
  *
  * Empty extras renders to ~2 lines so the per-turn token cost is bounded;
- * the catalog of facts only grows as later phases add semantic state
- * (Phase 3.2 task list, etc.).
+ * the catalog of facts only grows as later phases add semantic state.
  */
 export function buildSystemReminder(ctx) {
     const lines = ["<system-reminder>"];
     // Session id — emitted so cross-session tools (ask_session, tell_session,
     // fork helpers) have a stable handle to reference without round-tripping.
     lines.push(`Session: ${ctx.sessionId}`);
-    // TodoWrite read-side: render the current list (if any) so the model
-    // doesn't need a `todo_list` tool. Compact one-line-per-entry format
-    // tracks `[✓/→/ ] task-N  content` — matches the tool result preview
-    // so the model sees the same shape it wrote.
-    if (ctx.todos && ctx.todos.length > 0) {
-        lines.push(`Task list (${todoSummaryCount(ctx.todos)}):`);
-        for (const t of ctx.todos) {
+    // Task list read-side: render the current list (if any) so the model
+    // doesn't need to call TaskList every turn. Compact one-line-per-entry
+    // format `[✓/→/ ] #N  subject (blocked by #M)` matches Claude Code's
+    // TaskList rendering closely enough that the model's pretrained instincts
+    // about the shape transfer cleanly.
+    if (ctx.tasks && ctx.tasks.length > 0) {
+        lines.push(`Tasks (${taskSummaryCount(ctx.tasks)}):`);
+        for (const t of ctx.tasks) {
             const mark = t.status === "completed" ? "✓" : t.status === "in_progress" ? "→" : " ";
-            lines.push(`  [${mark}] ${t.id}  ${t.content}`);
+            const deps = t.blockedBy.length > 0
+                ? ` (blocked by ${t.blockedBy.map((id) => `#${id}`).join(", ")})`
+                : "";
+            const owner = t.owner ? ` [@${t.owner}]` : "";
+            lines.push(`  [${mark}] #${t.id}  ${t.subject}${owner}${deps}`);
         }
-        lines.push("Update this list with `todo_write` whenever you start a step, finish one, " +
-            "or change the plan. Only ONE item may be in_progress at a time.");
+        lines.push("Use TaskCreate to add tasks, TaskUpdate(taskId, status) to advance them, " +
+            "TaskUpdate(taskId, addBlockedBy/addBlocks) for dependencies. Only ONE " +
+            "task may be in_progress at a time — setting another flips the prior one " +
+            "back to pending.");
     }
     // Caller-supplied tail. Each extra is one line — caller owns formatting.
     for (const e of ctx.extras ?? []) {
@@ -34,8 +40,8 @@ export function buildSystemReminder(ctx) {
 }
 /** Compact "3/5" style summary — completed over total. Used in the list
  *  header so the model gets progress at a glance without re-counting. */
-function todoSummaryCount(todos) {
-    const done = todos.filter((t) => t.status === "completed").length;
-    return `${done}/${todos.length}`;
+function taskSummaryCount(tasks) {
+    const done = tasks.filter((t) => t.status === "completed").length;
+    return `${done}/${tasks.length}`;
 }
 //# sourceMappingURL=reminder.js.map

package/dist/memory/reminder.js.map

@@ -1 +1 @@
-{"version":3,"file":"reminder.js","sourceRoot":"","sources":["../../src/memory/reminder.ts"],"names":[],"mappings":"AAiDA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAA0B;IAC5D,MAAM,KAAK,GAAa,CAAC,mBAAmB,CAAC,CAAC;IAE9C,0EAA0E;IAC1E,0EAA0E;IAC1E,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAExC,qEAAqE;IACrE,qEAAqE;IACrE,qEAAqE;IACrE,6CAA6C;IAC7C,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,cAAc,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACrF,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,CAAC,IAAI,CACR,4EAA4E;YAC1E,iEAAiE,CACpE,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;yEACyE;AACzE,SAAS,gBAAgB,CAAC,KAA2B;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAClE,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"reminder.js","sourceRoot":"","sources":["../../src/memory/reminder.ts"],"names":[],"mappings":"AAkDA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAA0B;IAC5D,MAAM,KAAK,GAAa,CAAC,mBAAmB,CAAC,CAAC;IAE9C,0EAA0E;IAC1E,0EAA0E;IAC1E,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAExC,qEAAqE;IACrE,uEAAuE;IACvE,qEAAqE;IACrE,0EAA0E;IAC1E,oCAAoC;IACpC,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,UAAU,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,IAAI,GACR,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1E,MAAM,IAAI,GACR,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;gBACpB,CAAC,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBACjE,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,IAAI,CACR,2EAA2E;YACzE,wEAAwE;YACxE,0EAA0E;YAC1E,kBAAkB,CACrB,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;yEACyE;AACzE,SAAS,gBAAgB,CAAC,KAA2B;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAClE,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;AACnC,CAAC"}

package/dist/platform/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Canonical SDK version constant.
+ *
+ * Lives in its own module so any subsystem (session-store, rollout encoders,
+ * logging) can import the version without pulling in the full public-API
+ * surface from `index.ts`. The `index.ts` re-export is what hosts consume —
+ * `MAESTRO_SDK_VERSION` is also stamped into every rollout's `_meta` header
+ * so a future SDK can detect on-disk format drift on load.
+ *
+ * Bump in lock-step with `package.json#version` on every release.
+ */
+export declare const MAESTRO_SDK_VERSION: "0.1.5";
+//# sourceMappingURL=version.d.ts.map

package/dist/platform/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/platform/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAG,OAAgB,CAAC"}

package/dist/platform/version.js

@@ -0,0 +1,13 @@
+/**
+ * Canonical SDK version constant.
+ *
+ * Lives in its own module so any subsystem (session-store, rollout encoders,
+ * logging) can import the version without pulling in the full public-API
+ * surface from `index.ts`. The `index.ts` re-export is what hosts consume —
+ * `MAESTRO_SDK_VERSION` is also stamped into every rollout's `_meta` header
+ * so a future SDK can detect on-disk format drift on load.
+ *
+ * Bump in lock-step with `package.json#version` on every release.
+ */
+export const MAESTRO_SDK_VERSION = "0.1.5";
+//# sourceMappingURL=version.js.map

package/dist/platform/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/platform/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC"}