ytdb-slate 0.1.0 → 0.1.1

package/README.md

@@ -23,7 +23,7 @@ Optional config file: `slate.json` in the project's pi config dir (`.pi/slate.js
 | `orchestratorModeDefault` | boolean | `false` | Start fresh interactive sessions with orchestrator mode ON. |
 | `episodeModel` | string | newest available Anthropic Sonnet, else the worker's own model | Model (`provider/id`) used to compress a finished action into an episode. |
 | `workerTools` | string[] | `["read", "bash", "edit", "write", "grep", "find", "ls"]` | Tools available to worker threads (an empty list also falls back to the default). |
-| `maxConcurrent` | number | `4` | Maximum number of worker actions running concurrently. |
+| `maxConcurrent` | number | `4` | Maximum number of worker actions running concurrently (must be ≥ 1 — unenforced: a value of 0 or less silently hangs all dispatches). Excess dispatches wait in a queue; actions on the same thread always run in dispatch order. Default rationale: shipped `docs/design-principles.md` §5 (repo-local note). |
 | `pauseThresholdPercent` | number | `40` | Orchestrator context budget (percent, in `(0, 100]`) at which Slate auto-pauses and prepares a fresh-session handoff. |
 | `orchestratorPromptDocs` | string[] | `[]` | Project markdown files (paths relative to the project root) whose **contents** are appended to the orchestrator system prompt. |
 | `workerPromptDocs` | string[] | `[]` | Project markdown files whose **contents** are appended to every worker-thread system prompt. |

package/docs/design-principles.md

@@ -151,6 +151,19 @@ or two problems for the others:
 | P9 parallelism | `threads.ts` `maxConcurrent` queueing; doctrine rule 2 in `mode.ts` |
 | P10 context as RAM | `handoff.ts` context-budget auto-pause + fresh-session handoff |
 
+Repo-local note (not from the report): the `maxConcurrent` cap defaults
+to 4. Its failure modes are asymmetric: excess dispatches wait for a
+slot (actions on the same thread additionally serialize in dispatch
+order), so a low cap costs only latency, while a cap above the
+provider's effective rate limits turns rate-limit exhaustion into
+FAILED episodes and raises the unattended cost burn rate. Over its
+lifetime a slot covers a multi-turn worker conversation followed by its
+episode-compression call. The default is sized to cover typical
+parallel batches (recon fan-outs, a review wave of a few perspectives)
+while staying safe on common consumer API tiers; wider fan-outs only
+pay tail latency, and projects with higher-tier keys raise the cap in
+`slate.json`.
+
 ## 6. Runtime knowledge: what the orchestrator knows, and when
 
 The orchestrator's knowledge of these principles is two-tier, following

package/extension/state.ts

@@ -45,7 +45,7 @@ export interface SlateSnapshot {
 export interface SlateConfig {
 	episodeModel?: string; // "provider/id" for the episode compressor (D5)
 	workerTools?: string[];
-	maxConcurrent?: number;
+	maxConcurrent?: number; // global cap on concurrently running worker actions (default 4; must be ≥ 1 — unenforced, ≤ 0 silently hangs all dispatches; rationale: docs/design-principles.md §5 repo-local note)
 	pauseThresholdPercent?: number; // orchestrator context budget for auto-pause (default 40)
 	orchestratorModeDefault?: boolean; // seed orchestrator mode ON for fresh interactive sessions (unsaved until first real mutation)
 	orchestratorPromptDocs?: string[]; // role-guideline docs appended to the orchestrator prompt (cwd-relative paths, default none)

package/extension/threads.ts

@@ -83,7 +83,7 @@ export class ThreadManager {
 		private store: SlateStore,
 		private config: SlateConfig,
 	) {
-		this.semaphore = new Semaphore(config.maxConcurrent ?? 4);
+		this.semaphore = new Semaphore(config.maxConcurrent ?? 4); // default rationale: docs/design-principles.md §5 repo-local note
 	}
 
 	getConfig(): SlateConfig {

package/extension/worker.ts

@@ -14,12 +14,10 @@
 import { mkdirSync } from "node:fs";
 import { resolve } from "node:path";
 import {
-	AuthStorage,
 	CONFIG_DIR_NAME,
 	createAgentSession,
 	DefaultResourceLoader,
 	getAgentDir,
-	ModelRegistry,
 	SessionManager,
 	SettingsManager,
 	type ExtensionContext,
@@ -66,8 +64,6 @@ export async function openWorkerSession(opts: {
 	mkdirSync(dir, { recursive: true });
 
 	const agentDir = getAgentDir();
-	const authStorage = AuthStorage.create();
-	const modelRegistry = ModelRegistry.create(authStorage);
 
 	// Trust propagation (mirrors vanilla pi's runtime SettingsManager): when no
 	// settingsManager is passed, the SDK default-constructs one with
@@ -104,11 +100,16 @@ export async function openWorkerSession(opts: {
 		? SessionManager.open(opts.sessionFile)
 		: SessionManager.create(ctx.cwd, dir);
 
+	// No modelRuntime passed: createAgentSession (pi >= 0.80.8) defaults to a
+	// ModelRuntime replacing the AuthStorage + ModelRegistry setup this code
+	// hand-built before those SDK options were removed. Credential/config
+	// sources are unchanged — global agentDir auth.json + models.json, never
+	// project-local — but the default is a superset: it also reads/writes
+	// agentDir/models-store.json and may run a throttled (~4h-cached)
+	// create-time network catalog refresh (disabled by PI_OFFLINE).
 	const { session } = await createAgentSession({
 		cwd: ctx.cwd,
 		agentDir,
-		authStorage,
-		modelRegistry,
 		model: model ?? undefined,
 		tools: opts.tools && opts.tools.length > 0 ? opts.tools : DEFAULT_WORKER_TOOLS,
 		resourceLoader: loader,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ytdb-slate",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Slate: a thread-weaving orchestration extension for the pi coding agent — bounded worker actions, compressed episodes, mandatory research/design/adversarial/track review workflow, optional draft-PR publishing.",
   "license": "Apache-2.0",
   "keywords": [