@compilr-dev/sdk 0.16.0 → 0.17.1

package/dist/canvas/types.d.ts

@@ -3,8 +3,8 @@
  *
  * A Canvas is a persisted visual artifact the agent authors as HTML/SVG, with an
  * optional controls manifest that surfaces live parameters ("Tweaks"). These
- * types are the host-agnostic contract: the SDK owns them + the tools; hosts
- * (Desktop) own the renderer.
+ * types are the host-agnostic contract: the SDK owns them + the repository + the
+ * tools; hosts (Desktop) own the renderer.
  *
  * Intentionally dependency-free so this module can be exposed at the renderer-safe
  * subpath `@compilr-dev/sdk/canvas` (the Desktop renderer needs the control types
@@ -68,10 +68,13 @@ export type Control = SliderControl | NumberControl | ToggleControl | SelectCont
 export interface ControlManifest {
     controls: Control[];
 }
-/** Full persisted canvas. `content` is the agent's raw HTML/SVG only — the CSP + bridge are injected by the host renderer, never stored. */
+/**
+ * Full persisted canvas. `content` is the agent's raw HTML/SVG only — the CSP +
+ * bridge are injected by the host renderer, never stored.
+ */
 export interface CanvasRecord {
-    id: string;
-    projectId: string;
+    id: number;
+    projectId: number;
     type: CanvasType;
     title: string;
     content: string;
@@ -83,31 +86,20 @@ export interface CanvasRecord {
 }
 /** Lightweight list entry (no content). */
 export interface CanvasSummary {
-    id: string;
-    projectId: string;
+    id: number;
+    projectId: number;
     type: CanvasType;
     title: string;
     updatedAt: Date;
 }
-/**
- * Host-implemented persistence for canvases (DB-backed). Optional field on
- * PlatformContext — the canvas tools are absent when a host doesn't provide it.
- */
-export interface ICanvasService {
-    create(input: {
-        type: CanvasType;
-        title: string;
-        content: string;
-        controls?: ControlManifest;
-        values?: Record<string, ParamValue>;
-        /** Defaults to the current project when omitted. */
-        projectId?: string;
-    }): Promise<CanvasRecord>;
-    update(id: string, patch: Partial<Pick<CanvasRecord, 'title' | 'content' | 'controls' | 'values'>>): Promise<CanvasRecord>;
-    get(id: string): Promise<CanvasRecord | null>;
-    /** Metadata only; scoped to the current project when projectId omitted. */
-    list(projectId?: string): Promise<CanvasSummary[]>;
-    delete(id: string): Promise<CanvasRecord | null>;
+export interface CreateCanvasInput {
+    projectId: number;
+    type: CanvasType;
+    title: string;
+    content: string;
+    controls?: ControlManifest;
+    values?: Record<string, ParamValue>;
 }
+export type UpdateCanvasInput = Partial<Pick<CanvasRecord, 'title' | 'content' | 'controls' | 'values'>>;
 /** Seed a values map from a manifest's control defaults. */
 export declare function seedValues(manifest: ControlManifest | undefined): Record<string, ParamValue>;

package/dist/canvas/types.js

@@ -3,8 +3,8 @@
  *
  * A Canvas is a persisted visual artifact the agent authors as HTML/SVG, with an
  * optional controls manifest that surfaces live parameters ("Tweaks"). These
- * types are the host-agnostic contract: the SDK owns them + the tools; hosts
- * (Desktop) own the renderer.
+ * types are the host-agnostic contract: the SDK owns them + the repository + the
+ * tools; hosts (Desktop) own the renderer.
  *
  * Intentionally dependency-free so this module can be exposed at the renderer-safe
  * subpath `@compilr-dev/sdk/canvas` (the Desktop renderer needs the control types

package/dist/index.d.ts

@@ -53,7 +53,7 @@ export { CapabilityManager, CapabilityContext, createCapabilityHook, autoDetectC
 export type { CapabilityPack, CapabilityTier, LoadedCapability, CapabilityCatalogEntry, CapabilityLoadResult, CapabilityManagerConfig, CapabilityContextConfig, CapabilityHookConfig, ConditionalModule, AutoDetectResult, } from './capabilities/index.js';
 export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_HINTS_MODULE, PLATFORM_TOOL_HINTS_MODULE, FACTORY_TOOL_HINTS_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, VISUAL_OUTPUT_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './system-prompt/index.js';
 export type { SystemPromptContext, BuildResult, SystemPromptModule, ModuleConditions, } from './system-prompt/index.js';
-export type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleState, WorkItemType, WorkItemStatus, WorkItemPriority, GuidedStep, DocumentType, PlanStatus, Project, WorkItem, ProjectDocument, Plan, PlanSummary, PlanWithWorkItem, HistoryEntry, CreateProjectInput, UpdateProjectInput, ProjectListOptions, CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, CreateDocumentInput, UpdateDocumentInput, CreatePlanInput, UpdatePlanInput, ListPlansOptions, WorkItemQueryResult, ProjectListResult, BulkCreateItem, WorkItemComment, CreateCommentInput, UpdateCommentInput, IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository, IAnchorService, IArtifactService, IEpisodeService, AnchorData, ArtifactType, ArtifactData, ArtifactSummaryData, WorkEpisode, ProjectWorkSummary, PlatformContext, PlatformToolsConfig, PlatformHooks, StepCriteria, } from './platform/index.js';
+export type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleState, WorkItemType, WorkItemStatus, WorkItemPriority, GuidedStep, DocumentType, PlanStatus, Project, WorkItem, ProjectDocument, Plan, PlanSummary, PlanWithWorkItem, HistoryEntry, CreateProjectInput, UpdateProjectInput, ProjectListOptions, CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, CreateDocumentInput, UpdateDocumentInput, CreatePlanInput, UpdatePlanInput, ListPlansOptions, WorkItemQueryResult, ProjectListResult, BulkCreateItem, WorkItemComment, CreateCommentInput, UpdateCommentInput, IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository, ICanvasRepository, IAnchorService, IArtifactService, IEpisodeService, AnchorData, ArtifactType, ArtifactData, ArtifactSummaryData, WorkEpisode, ProjectWorkSummary, PlatformContext, PlatformToolsConfig, PlatformHooks, StepCriteria, } from './platform/index.js';
 export { createSQLiteRepositories, SQLiteProjectRepository, SQLiteWorkItemRepository, SQLiteDocumentRepository, SQLitePlanRepository, SQLiteCommentRepository, getDatabase, closeDatabase, closeAllDatabases, databaseExists, SCHEMA_VERSION, SCHEMA_SQL, } from './platform/index.js';
 export type { SQLiteRepositories, CreateSQLiteRepositoriesOptions, ProjectDeleteHooks, ProjectRecord, WorkItemRecord, ProjectDocumentRecord, WorkItemCommentRecord, } from './platform/index.js';
 export { createAskUserTool, createAskUserSimpleTool, createProposeAlternativesTool, createInteractiveFlowTool, validateFlow, INTERACTIVE_FLOW_INPUT_SCHEMA, } from './tools/index.js';
@@ -81,7 +81,7 @@ export { defineTool, createSuccessResult, createErrorResult, mergeHooks, createL
 export { classifyAgentError, isApiKeyError } from './errors/classify.js';
 export type { AgentErrorCategory, AgentErrorInfo } from './errors/classify.js';
 export { validateControlManifest, seedValues } from './canvas/index.js';
-export type { CanvasType, ParamValue, Control, ControlManifest, CanvasRecord, CanvasSummary, ICanvasService, SliderControl, NumberControl, ToggleControl, SelectControl, ColorControl, TextControl, ManifestValidationResult, } from './canvas/index.js';
+export type { CanvasType, ParamValue, Control, ControlManifest, CanvasRecord, CanvasSummary, CreateCanvasInput, UpdateCanvasInput, SliderControl, NumberControl, ToggleControl, SelectControl, ColorControl, TextControl, ManifestValidationResult, } from './canvas/index.js';
 export type { Tool, HooksConfig, AgentEvent, Message, LLMProvider, AnchorInput, ToolExecutionResult, AgentRunResult, PermissionHandler, PermissionHandlerResponse, ToolPermission, AgentTypeConfig, GuardrailTriggeredHandler, BeforeLLMHookResult, BeforeToolHook, BeforeToolHookResult, AfterToolHook, AgentState, AgentConfig, SessionInfo, Anchor, AnchorScope, AnchorClearOptions, AnchorPriority, AnchorQueryOptions, FileAccessType, FileAccess, GuardrailResult, GuardrailContext, MCPClient, MCPToolDefinition, } from '@compilr-dev/agents';
 export { DEFAULT_PERMISSION_RULES, WRITE_TOOLS, findMatchingRule, permissionModeLabel, permissionLevelLabel, } from './permissions.js';
 export type { PermissionRule, PermissionMode, PermissionLevel } from './permissions.js';

package/dist/platform/context.d.ts

@@ -4,9 +4,8 @@
  * Provides a single entry point for data access, abstracting over the
  * underlying storage backend (SQLite in CLI, PostgreSQL in web/API).
  */
-import type { IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository } from './repositories.js';
+import type { IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository, ICanvasRepository } from './repositories.js';
 import type { IAnchorService, IArtifactService, IEpisodeService } from './services.js';
-import type { ICanvasService } from '../canvas/types.js';
 export interface PlatformContext {
     readonly projects: IProjectRepository;
     readonly workItems: IWorkItemRepository;
@@ -16,7 +15,7 @@ export interface PlatformContext {
     readonly anchors?: IAnchorService;
     readonly artifacts?: IArtifactService;
     readonly episodes?: IEpisodeService;
-    readonly canvas?: ICanvasService;
+    readonly canvases?: ICanvasRepository;
     readonly comments?: ICommentRepository;
 }
 export interface PlatformHooks {

package/dist/platform/index.d.ts

@@ -2,7 +2,7 @@
  * Platform — Repository interfaces, data models, tools, and workflow.
  */
 export type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleState, WorkItemType, WorkItemStatus, WorkItemPriority, GuidedStep, DocumentType, PlanStatus, Project, WorkItem, ProjectDocument, Plan, PlanSummary, PlanWithWorkItem, HistoryEntry, CreateProjectInput, UpdateProjectInput, ProjectListOptions, CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, CreateDocumentInput, UpdateDocumentInput, CreatePlanInput, UpdatePlanInput, ListPlansOptions, WorkItemQueryResult, ProjectListResult, BulkCreateItem, WorkItemComment, CreateCommentInput, UpdateCommentInput, } from './types.js';
-export type { IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository, } from './repositories.js';
+export type { IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository, ICanvasRepository, } from './repositories.js';
 export type { IAnchorService, IArtifactService, IEpisodeService, AnchorData, ArtifactType, ArtifactData, ArtifactSummaryData, WorkEpisode, ProjectWorkSummary, } from './services.js';
 export type { PlatformContext, PlatformToolsConfig, PlatformHooks } from './context.js';
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createCanvasTools, createImageTools, } from './tools/index.js';

package/dist/platform/repositories.d.ts

@@ -6,6 +6,7 @@
  * backends (PostgreSQL, HTTP APIs).
  */
 import type { Project, WorkItem, WorkItemComment, ProjectDocument, Plan, PlanSummary, PlanWithWorkItem, HistoryEntry, CreateProjectInput, UpdateProjectInput, ProjectListOptions, CreateWorkItemInput, UpdateWorkItemInput, QueryWorkItemsInput, CreateCommentInput, UpdateCommentInput, CreateDocumentInput, UpdateDocumentInput, CreatePlanInput, UpdatePlanInput, ListPlansOptions, WorkItemQueryResult, ProjectListResult, BulkCreateItem, ProjectStatus, WorkItemType, WorkItemStatus, DocumentType, PlanStatus } from './types.js';
+import type { CanvasRecord, CanvasSummary, CreateCanvasInput, UpdateCanvasInput } from '../canvas/types.js';
 export interface IProjectRepository {
     create(input: CreateProjectInput): Promise<Project>;
     getById(id: number): Promise<Project | null>;
@@ -46,6 +47,13 @@ export interface IDocumentRepository {
     deleteByType(projectId: number, docType: DocumentType): Promise<boolean>;
     getTypeCounts(projectId: number): Promise<Record<string, number>>;
 }
+export interface ICanvasRepository {
+    create(input: CreateCanvasInput): Promise<CanvasRecord>;
+    getById(id: number): Promise<CanvasRecord | null>;
+    listByProject(projectId: number): Promise<CanvasSummary[]>;
+    update(id: number, input: UpdateCanvasInput): Promise<CanvasRecord | null>;
+    delete(id: number): Promise<boolean>;
+}
 export interface IPlanRepository {
     create(input: CreatePlanInput): Promise<Plan>;
     getById(id: number): Promise<Plan | null>;

package/dist/platform/sqlite/canvas-repository.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SQLite Canvas Repository — concrete implementation of ICanvasRepository.
+ *
+ * `controls` and `values` are stored as JSON text columns. Note `values` is a
+ * SQL reserved word, so it is always quoted as "values" in statements.
+ */
+import type Database from 'better-sqlite3';
+import type { ICanvasRepository } from '../repositories.js';
+import type { CanvasRecord, CanvasSummary, CreateCanvasInput, UpdateCanvasInput } from '../../canvas/types.js';
+export declare class SQLiteCanvasRepository implements ICanvasRepository {
+    private readonly db;
+    constructor(db: Database.Database);
+    create(input: CreateCanvasInput): Promise<CanvasRecord>;
+    getById(id: number): Promise<CanvasRecord | null>;
+    listByProject(projectId: number): Promise<CanvasSummary[]>;
+    update(id: number, input: UpdateCanvasInput): Promise<CanvasRecord | null>;
+    delete(id: number): Promise<boolean>;
+}

package/dist/platform/sqlite/canvas-repository.js

@@ -0,0 +1,93 @@
+/**
+ * SQLite Canvas Repository — concrete implementation of ICanvasRepository.
+ *
+ * `controls` and `values` are stored as JSON text columns. Note `values` is a
+ * SQL reserved word, so it is always quoted as "values" in statements.
+ */
+function parseControls(json) {
+    try {
+        const parsed = JSON.parse(json);
+        return Array.isArray(parsed.controls) ? { controls: parsed.controls } : { controls: [] };
+    }
+    catch {
+        return { controls: [] };
+    }
+}
+function parseValues(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return {};
+    }
+}
+function toCanvas(r) {
+    return {
+        id: r.id,
+        projectId: r.project_id,
+        type: r.type,
+        title: r.title,
+        content: r.content,
+        controls: parseControls(r.controls),
+        values: parseValues(r.values),
+        createdAt: new Date(r.created_at),
+        updatedAt: new Date(r.updated_at),
+    };
+}
+function toSummary(r) {
+    return {
+        id: r.id,
+        projectId: r.project_id,
+        type: r.type,
+        title: r.title,
+        updatedAt: new Date(r.updated_at),
+    };
+}
+export class SQLiteCanvasRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(input) {
+        const now = new Date().toISOString();
+        const controls = JSON.stringify(input.controls ?? { controls: [] });
+        const values = JSON.stringify(input.values ?? {});
+        const result = this.db
+            .prepare(`INSERT INTO canvases (project_id, type, title, content, controls, "values", created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(input.projectId, input.type, input.title, input.content, controls, values, now, now);
+        const record = this.db
+            .prepare('SELECT * FROM canvases WHERE id = ?')
+            .get(Number(result.lastInsertRowid));
+        return Promise.resolve(toCanvas(record));
+    }
+    getById(id) {
+        const record = this.db.prepare('SELECT * FROM canvases WHERE id = ?').get(id);
+        return Promise.resolve(record ? toCanvas(record) : null);
+    }
+    listByProject(projectId) {
+        const rows = this.db
+            .prepare('SELECT * FROM canvases WHERE project_id = ? ORDER BY updated_at DESC')
+            .all(projectId);
+        return Promise.resolve(rows.map(toSummary));
+    }
+    update(id, input) {
+        const existing = this.db.prepare('SELECT * FROM canvases WHERE id = ?').get(id);
+        if (!existing)
+            return Promise.resolve(null);
+        const now = new Date().toISOString();
+        const title = input.title ?? existing.title;
+        const content = input.content ?? existing.content;
+        const controls = input.controls ? JSON.stringify(input.controls) : existing.controls;
+        const values = input.values ? JSON.stringify(input.values) : existing.values;
+        this.db
+            .prepare(`UPDATE canvases SET title = ?, content = ?, controls = ?, "values" = ?, updated_at = ? WHERE id = ?`)
+            .run(title, content, controls, values, now, id);
+        const record = this.db.prepare('SELECT * FROM canvases WHERE id = ?').get(id);
+        return Promise.resolve(toCanvas(record));
+    }
+    delete(id) {
+        const result = this.db.prepare('DELETE FROM canvases WHERE id = ?').run(id);
+        return Promise.resolve(result.changes > 0);
+    }
+}

package/dist/platform/sqlite/db.js

@@ -157,4 +157,22 @@ function runMigrations(db, fromVersion, toVersion) {
     `);
         db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(7);
     }
+    if (fromVersion < 8 && toVersion >= 8) {
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS canvases (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        project_id INTEGER NOT NULL,
+        type TEXT NOT NULL,
+        title TEXT NOT NULL,
+        content TEXT NOT NULL,
+        controls TEXT NOT NULL DEFAULT '{"controls":[]}',
+        "values" TEXT NOT NULL DEFAULT '{}',
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+        FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_canvases_project ON canvases(project_id);
+    `);
+        db.prepare('INSERT INTO schema_version (version) VALUES (?)').run(8);
+    }
 }

package/dist/platform/sqlite/index.d.ts

@@ -17,13 +17,14 @@
  */
 import type Database from 'better-sqlite3';
 import { type ProjectDeleteHooks } from './project-repository.js';
-import type { IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository } from '../repositories.js';
+import type { IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository, ICanvasRepository } from '../repositories.js';
 export interface SQLiteRepositories {
     projects: IProjectRepository;
     workItems: IWorkItemRepository;
     documents: IDocumentRepository;
     plans: IPlanRepository;
     comments: ICommentRepository;
+    canvases: ICanvasRepository;
 }
 export interface CreateSQLiteRepositoriesOptions {
     projectDeleteHooks?: ProjectDeleteHooks;
@@ -37,6 +38,7 @@ export { SQLiteWorkItemRepository } from './work-item-repository.js';
 export { SQLiteDocumentRepository } from './document-repository.js';
 export { SQLitePlanRepository } from './plan-repository.js';
 export { SQLiteCommentRepository } from './comment-repository.js';
+export { SQLiteCanvasRepository } from './canvas-repository.js';
 export { getDatabase, closeDatabase, closeAllDatabases, databaseExists } from './db.js';
 export { SCHEMA_VERSION, SCHEMA_SQL } from './schema.js';
 export type { ProjectRecord, WorkItemRecord, ProjectDocumentRecord, WorkItemCommentRecord, } from './schema.js';

package/dist/platform/sqlite/index.js

@@ -20,6 +20,7 @@ import { SQLiteWorkItemRepository } from './work-item-repository.js';
 import { SQLiteDocumentRepository } from './document-repository.js';
 import { SQLitePlanRepository } from './plan-repository.js';
 import { SQLiteCommentRepository } from './comment-repository.js';
+import { SQLiteCanvasRepository } from './canvas-repository.js';
 /**
  * Create all 4 platform repositories backed by a single SQLite database.
  */
@@ -30,6 +31,7 @@ export function createSQLiteRepositories(db, options) {
         documents: new SQLiteDocumentRepository(db),
         plans: new SQLitePlanRepository(db),
         comments: new SQLiteCommentRepository(db),
+        canvases: new SQLiteCanvasRepository(db),
     };
 }
 // Re-export classes for advanced usage
@@ -38,6 +40,7 @@ export { SQLiteWorkItemRepository } from './work-item-repository.js';
 export { SQLiteDocumentRepository } from './document-repository.js';
 export { SQLitePlanRepository } from './plan-repository.js';
 export { SQLiteCommentRepository } from './comment-repository.js';
+export { SQLiteCanvasRepository } from './canvas-repository.js';
 // Re-export database utilities
 export { getDatabase, closeDatabase, closeAllDatabases, databaseExists } from './db.js';
 // Re-export schema (for consumers that need direct access)

package/dist/platform/sqlite/schema.d.ts

@@ -4,8 +4,8 @@
  * Shared between CLI and Desktop — both access ~/.compilr-dev/projects.db
  * Schema version must be kept in sync across all consumers.
  */
-export declare const SCHEMA_VERSION = 7;
-export declare const SCHEMA_SQL = "\n-- Schema version tracking\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER PRIMARY KEY,\n  applied_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\n-- Projects table\nCREATE TABLE IF NOT EXISTS projects (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  name TEXT UNIQUE NOT NULL,\n  display_name TEXT NOT NULL,\n  description TEXT,\n  type TEXT DEFAULT 'general',\n  status TEXT DEFAULT 'active',\n  path TEXT NOT NULL,\n  docs_path TEXT,\n  repo_pattern TEXT DEFAULT 'single',\n  language TEXT,\n  framework TEXT,\n  package_manager TEXT,\n  runtime_version TEXT,\n  commands TEXT,\n  git_remote TEXT,\n  git_branch TEXT DEFAULT 'main',\n  workflow_mode TEXT DEFAULT 'flexible',\n  lifecycle_state TEXT DEFAULT 'setup',\n  current_item_id TEXT,\n  last_context TEXT,\n  metadata TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  last_activity_at DATETIME\n);\n\n-- Work items (backlog items, tasks, bugs)\nCREATE TABLE IF NOT EXISTS work_items (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n  item_number INTEGER NOT NULL,\n  item_id TEXT NOT NULL,\n  type TEXT NOT NULL,\n  status TEXT DEFAULT 'backlog',\n  priority TEXT DEFAULT 'medium',\n  guided_step TEXT,\n  owner TEXT,\n  title TEXT NOT NULL,\n  description TEXT,\n  estimated_effort TEXT,\n  actual_minutes INTEGER,\n  completed_at DATETIME,\n  completed_by TEXT,\n  commit_hash TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  UNIQUE (project_id, item_id)\n);\n\n-- Project documents (PRD, architecture, plans, etc.)\nCREATE TABLE IF NOT EXISTS project_documents (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n  doc_type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n  status TEXT,\n  work_item_id INTEGER,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE SET NULL\n);\n\n-- Work item history (audit trail)\nCREATE TABLE IF NOT EXISTS work_item_history (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  work_item_id INTEGER NOT NULL,\n  project_id INTEGER NOT NULL,\n  action TEXT NOT NULL,\n  old_value TEXT,\n  new_value TEXT,\n  notes TEXT,\n  changed_by TEXT,\n  changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\n\n-- Indexes\nCREATE INDEX IF NOT EXISTS idx_projects_path ON projects(path);\nCREATE INDEX IF NOT EXISTS idx_projects_docs_path ON projects(docs_path);\nCREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);\nCREATE INDEX IF NOT EXISTS idx_work_items_project ON work_items(project_id);\nCREATE INDEX IF NOT EXISTS idx_work_items_status ON work_items(status);\nCREATE INDEX IF NOT EXISTS idx_work_items_priority ON work_items(priority);\nCREATE INDEX IF NOT EXISTS idx_work_items_owner ON work_items(owner);\nCREATE INDEX IF NOT EXISTS idx_project_documents_project ON project_documents(project_id);\nCREATE INDEX IF NOT EXISTS idx_project_documents_type ON project_documents(doc_type);\nCREATE INDEX IF NOT EXISTS idx_project_documents_status ON project_documents(status);\nCREATE INDEX IF NOT EXISTS idx_project_documents_work_item ON project_documents(work_item_id);\nCREATE INDEX IF NOT EXISTS idx_work_item_history_item ON work_item_history(work_item_id);\n\n-- Terminal sessions (multi-terminal awareness)\nCREATE TABLE IF NOT EXISTS terminal_sessions (\n  id TEXT PRIMARY KEY,\n  project_id INTEGER,\n  pid INTEGER NOT NULL,\n  tty_path TEXT,\n  label TEXT,\n  started_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  last_heartbeat DATETIME DEFAULT CURRENT_TIMESTAMP,\n  active_agent TEXT DEFAULT 'default',\n  agents_json TEXT DEFAULT '[]',\n  status TEXT DEFAULT 'active',\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE SET NULL\n);\nCREATE INDEX IF NOT EXISTS idx_terminal_sessions_project ON terminal_sessions(project_id);\nCREATE INDEX IF NOT EXISTS idx_terminal_sessions_status ON terminal_sessions(status);\n\n-- File locks (multi-terminal file lock awareness)\nCREATE TABLE IF NOT EXISTS file_locks (\n  path TEXT NOT NULL,\n  project_id INTEGER NOT NULL,\n  session_id TEXT NOT NULL,\n  agent_id TEXT NOT NULL,\n  locked_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  PRIMARY KEY (path, project_id),\n  FOREIGN KEY (session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS idx_file_locks_session ON file_locks(session_id);\n\n-- Session notifications (cross-session notifications)\nCREATE TABLE IF NOT EXISTS session_notifications (\n  id TEXT PRIMARY KEY,\n  project_id INTEGER NOT NULL,\n  from_session_id TEXT NOT NULL,\n  to_session_id TEXT,\n  type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  message TEXT,\n  payload_json TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  read_at DATETIME,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  FOREIGN KEY (from_session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_project ON session_notifications(project_id);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_to_session ON session_notifications(to_session_id);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_unread ON session_notifications(read_at);\n\n-- Work item comments\nCREATE TABLE IF NOT EXISTS work_item_comments (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  work_item_id INTEGER NOT NULL,\n  project_id INTEGER NOT NULL,\n  author TEXT NOT NULL,\n  content TEXT NOT NULL,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS idx_work_item_comments_work_item ON work_item_comments(work_item_id);\nCREATE INDEX IF NOT EXISTS idx_work_item_comments_project ON work_item_comments(project_id);\n";
+export declare const SCHEMA_VERSION = 8;
+export declare const SCHEMA_SQL = "\n-- Schema version tracking\nCREATE TABLE IF NOT EXISTS schema_version (\n  version INTEGER PRIMARY KEY,\n  applied_at DATETIME DEFAULT CURRENT_TIMESTAMP\n);\n\n-- Projects table\nCREATE TABLE IF NOT EXISTS projects (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  name TEXT UNIQUE NOT NULL,\n  display_name TEXT NOT NULL,\n  description TEXT,\n  type TEXT DEFAULT 'general',\n  status TEXT DEFAULT 'active',\n  path TEXT NOT NULL,\n  docs_path TEXT,\n  repo_pattern TEXT DEFAULT 'single',\n  language TEXT,\n  framework TEXT,\n  package_manager TEXT,\n  runtime_version TEXT,\n  commands TEXT,\n  git_remote TEXT,\n  git_branch TEXT DEFAULT 'main',\n  workflow_mode TEXT DEFAULT 'flexible',\n  lifecycle_state TEXT DEFAULT 'setup',\n  current_item_id TEXT,\n  last_context TEXT,\n  metadata TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  last_activity_at DATETIME\n);\n\n-- Work items (backlog items, tasks, bugs)\nCREATE TABLE IF NOT EXISTS work_items (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n  item_number INTEGER NOT NULL,\n  item_id TEXT NOT NULL,\n  type TEXT NOT NULL,\n  status TEXT DEFAULT 'backlog',\n  priority TEXT DEFAULT 'medium',\n  guided_step TEXT,\n  owner TEXT,\n  title TEXT NOT NULL,\n  description TEXT,\n  estimated_effort TEXT,\n  actual_minutes INTEGER,\n  completed_at DATETIME,\n  completed_by TEXT,\n  commit_hash TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  UNIQUE (project_id, item_id)\n);\n\n-- Project documents (PRD, architecture, plans, etc.)\nCREATE TABLE IF NOT EXISTS project_documents (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n  doc_type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n  status TEXT,\n  work_item_id INTEGER,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE SET NULL\n);\n\n-- Work item history (audit trail)\nCREATE TABLE IF NOT EXISTS work_item_history (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  work_item_id INTEGER NOT NULL,\n  project_id INTEGER NOT NULL,\n  action TEXT NOT NULL,\n  old_value TEXT,\n  new_value TEXT,\n  notes TEXT,\n  changed_by TEXT,\n  changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\n\n-- Indexes\nCREATE INDEX IF NOT EXISTS idx_projects_path ON projects(path);\nCREATE INDEX IF NOT EXISTS idx_projects_docs_path ON projects(docs_path);\nCREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);\nCREATE INDEX IF NOT EXISTS idx_work_items_project ON work_items(project_id);\nCREATE INDEX IF NOT EXISTS idx_work_items_status ON work_items(status);\nCREATE INDEX IF NOT EXISTS idx_work_items_priority ON work_items(priority);\nCREATE INDEX IF NOT EXISTS idx_work_items_owner ON work_items(owner);\nCREATE INDEX IF NOT EXISTS idx_project_documents_project ON project_documents(project_id);\nCREATE INDEX IF NOT EXISTS idx_project_documents_type ON project_documents(doc_type);\nCREATE INDEX IF NOT EXISTS idx_project_documents_status ON project_documents(status);\nCREATE INDEX IF NOT EXISTS idx_project_documents_work_item ON project_documents(work_item_id);\nCREATE INDEX IF NOT EXISTS idx_work_item_history_item ON work_item_history(work_item_id);\n\n-- Terminal sessions (multi-terminal awareness)\nCREATE TABLE IF NOT EXISTS terminal_sessions (\n  id TEXT PRIMARY KEY,\n  project_id INTEGER,\n  pid INTEGER NOT NULL,\n  tty_path TEXT,\n  label TEXT,\n  started_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  last_heartbeat DATETIME DEFAULT CURRENT_TIMESTAMP,\n  active_agent TEXT DEFAULT 'default',\n  agents_json TEXT DEFAULT '[]',\n  status TEXT DEFAULT 'active',\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE SET NULL\n);\nCREATE INDEX IF NOT EXISTS idx_terminal_sessions_project ON terminal_sessions(project_id);\nCREATE INDEX IF NOT EXISTS idx_terminal_sessions_status ON terminal_sessions(status);\n\n-- File locks (multi-terminal file lock awareness)\nCREATE TABLE IF NOT EXISTS file_locks (\n  path TEXT NOT NULL,\n  project_id INTEGER NOT NULL,\n  session_id TEXT NOT NULL,\n  agent_id TEXT NOT NULL,\n  locked_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  PRIMARY KEY (path, project_id),\n  FOREIGN KEY (session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS idx_file_locks_session ON file_locks(session_id);\n\n-- Session notifications (cross-session notifications)\nCREATE TABLE IF NOT EXISTS session_notifications (\n  id TEXT PRIMARY KEY,\n  project_id INTEGER NOT NULL,\n  from_session_id TEXT NOT NULL,\n  to_session_id TEXT,\n  type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  message TEXT,\n  payload_json TEXT,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  read_at DATETIME,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,\n  FOREIGN KEY (from_session_id) REFERENCES terminal_sessions(id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_project ON session_notifications(project_id);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_to_session ON session_notifications(to_session_id);\nCREATE INDEX IF NOT EXISTS idx_session_notifications_unread ON session_notifications(read_at);\n\n-- Work item comments\nCREATE TABLE IF NOT EXISTS work_item_comments (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  work_item_id INTEGER NOT NULL,\n  project_id INTEGER NOT NULL,\n  author TEXT NOT NULL,\n  content TEXT NOT NULL,\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (work_item_id) REFERENCES work_items(id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS idx_work_item_comments_work_item ON work_item_comments(work_item_id);\nCREATE INDEX IF NOT EXISTS idx_work_item_comments_project ON work_item_comments(project_id);\n\n-- Canvases (visual reasoning surfaces: infographic / carousel / board)\nCREATE TABLE IF NOT EXISTS canvases (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id INTEGER NOT NULL,\n  type TEXT NOT NULL,\n  title TEXT NOT NULL,\n  content TEXT NOT NULL,\n  controls TEXT NOT NULL DEFAULT '{\"controls\":[]}',\n  \"values\" TEXT NOT NULL DEFAULT '{}',\n  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS idx_canvases_project ON canvases(project_id);\n";
 export interface ProjectRecord {
     id: number;
     name: string;
@@ -63,6 +63,17 @@ export interface ProjectDocumentRecord {
     created_at: string;
     updated_at: string;
 }
+export interface CanvasDbRecord {
+    id: number;
+    project_id: number;
+    type: string;
+    title: string;
+    content: string;
+    controls: string;
+    values: string;
+    created_at: string;
+    updated_at: string;
+}
 export interface WorkItemCommentRecord {
     id: number;
     work_item_id: number;

package/dist/platform/sqlite/schema.js

@@ -4,7 +4,7 @@
  * Shared between CLI and Desktop — both access ~/.compilr-dev/projects.db
  * Schema version must be kept in sync across all consumers.
  */
-export const SCHEMA_VERSION = 7;
+export const SCHEMA_VERSION = 8;
 export const SCHEMA_SQL = `
 -- Schema version tracking
 CREATE TABLE IF NOT EXISTS schema_version (
@@ -171,4 +171,19 @@ CREATE TABLE IF NOT EXISTS work_item_comments (
 );
 CREATE INDEX IF NOT EXISTS idx_work_item_comments_work_item ON work_item_comments(work_item_id);
 CREATE INDEX IF NOT EXISTS idx_work_item_comments_project ON work_item_comments(project_id);
+
+-- Canvases (visual reasoning surfaces: infographic / carousel / board)
+CREATE TABLE IF NOT EXISTS canvases (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  controls TEXT NOT NULL DEFAULT '{"controls":[]}',
+  "values" TEXT NOT NULL DEFAULT '{}',
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_canvases_project ON canvases(project_id);
 `;

package/dist/platform/tools/canvas-tools.d.ts

@@ -5,7 +5,8 @@
  *
  * `content` is the agent's raw HTML/SVG; the host renderer injects the CSP +
  * bridge and renders it in a sandboxed iframe. `controls` is the optional Tweaks
- * manifest (validated here). Persistence is delegated to ICanvasService.
+ * manifest (validated here). Persistence is delegated to ctx.canvases
+ * (ICanvasRepository); the current project is resolved like the document tools.
  */
 import type { PlatformToolsConfig } from '../context.js';
 import type { ControlManifest } from '../../canvas/types.js';
@@ -14,8 +15,8 @@ export declare function createCanvasTools(config: PlatformToolsConfig): (import(
     title: string;
     html: string;
     controls?: ControlManifest;
-    canvasId?: string;
-    projectId?: string;
+    canvas_id?: number;
+    project_id?: number;
 }> | import("@compilr-dev/agents").Tool<{
-    canvasId: string;
+    canvas_id: number;
 }>)[];

package/dist/platform/tools/canvas-tools.js

@@ -5,7 +5,8 @@
  *
  * `content` is the agent's raw HTML/SVG; the host renderer injects the CSP +
  * bridge and renders it in a sandboxed iframe. `controls` is the optional Tweaks
- * manifest (validated here). Persistence is delegated to ICanvasService.
+ * manifest (validated here). Persistence is delegated to ctx.canvases
+ * (ICanvasRepository); the current project is resolved like the document tools.
  */
 import { defineTool, createSuccessResult, createErrorResult } from '@compilr-dev/agents';
 import { truncateContent } from './truncate.js';
@@ -14,11 +15,12 @@ import { validateControlManifest } from '../../canvas/validate.js';
 const CANVAS_TYPES = ['infographic', 'carousel', 'board'];
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export function createCanvasTools(config) {
-    const canvas = config.context.canvas;
-    if (!canvas)
-        throw new Error('canvas service required');
+    const ctx = config.context;
+    const canvases = ctx.canvases;
+    if (!canvases)
+        throw new Error('canvases repository required');
     // ---------------------------------------------------------------------------
-    // canvas_write — create (no canvasId) or update (canvasId given)
+    // canvas_write — create (no canvas_id) or update (canvas_id given)
     // ---------------------------------------------------------------------------
     const canvasWriteTool = defineTool({
         name: 'canvas_write',
@@ -27,7 +29,7 @@ export function createCanvasTools(config) {
             'each control is { type: slider|number|toggle|select|color|text, param, label, default, ...type config }. ' +
             'Bind params in your HTML via CSS custom properties var(--param), [data-bind="param"] text, and ' +
             '[data-show="param"] visibility; for computed updates define window.applyParams(values) in a <script>. ' +
-            'Pass canvasId to update an existing canvas; omit it to create a new one.',
+            'Pass canvas_id to update an existing canvas; omit it to create a new one.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -49,12 +51,12 @@ export function createCanvasTools(config) {
                         controls: { type: 'array', items: { type: 'object' } },
                     },
                 },
-                canvasId: {
-                    type: 'string',
+                canvas_id: {
+                    type: 'number',
                     description: 'Existing canvas id to update. Omit to create a new canvas.',
                 },
-                projectId: {
-                    type: 'string',
+                project_id: {
+                    type: 'number',
                     description: 'Optional project id. Defaults to the current project.',
                 },
             },
@@ -68,29 +70,34 @@ export function createCanvasTools(config) {
                         return createErrorResult(`Invalid controls manifest:\n- ${check.errors.join('\n- ')}`);
                     }
                 }
-                if (input.canvasId) {
-                    const updated = await canvas.update(input.canvasId, {
+                if (input.canvas_id !== undefined) {
+                    const updated = await canvases.update(input.canvas_id, {
                         title: input.title,
                         content: input.html,
                         // Re-seed values from the new manifest when controls are (re)declared.
-                        // Phase 1 keeps this simple; a later phase can preserve prior tweaks
-                        // for surviving params.
+                        // Phase 1 keeps this simple; a later phase can preserve prior tweaks.
                         ...(input.controls
                             ? { controls: input.controls, values: seedValues(input.controls) }
                             : {}),
                     });
-                    return createSuccessResult(`Updated canvas "${updated.title}" (${updated.type})\nID: ${updated.id}`);
+                    if (!updated)
+                        return createErrorResult(`Canvas ${String(input.canvas_id)} not found.`);
+                    return createSuccessResult(`Updated canvas "${updated.title}" (${updated.type})\nID: ${String(updated.id)}`);
+                }
+                const projectId = input.project_id ?? ctx.currentProjectId;
+                if (!projectId) {
+                    return createErrorResult('No active project. Provide project_id or select a project.');
                 }
                 const controls = input.controls ?? { controls: [] };
-                const created = await canvas.create({
+                const created = await canvases.create({
+                    projectId,
                     type: input.type,
                     title: input.title,
                     content: input.html,
                     controls,
                     values: seedValues(controls),
-                    projectId: input.projectId,
                 });
-                return createSuccessResult(`Created canvas "${created.title}" (${created.type})\nID: ${created.id}`);
+                return createSuccessResult(`Created canvas "${created.title}" (${created.type})\nID: ${String(created.id)}`);
             }
             catch (error) {
                 return createErrorResult(`Failed to write canvas: ${error instanceof Error ? error.message : String(error)}`);
@@ -106,16 +113,20 @@ export function createCanvasTools(config) {
         inputSchema: {
             type: 'object',
             properties: {
-                projectId: { type: 'string', description: 'Optional project id. Defaults to current.' },
+                project_id: { type: 'number', description: 'Optional project id. Defaults to current.' },
             },
             required: [],
         },
         execute: async (input) => {
             try {
-                const items = await canvas.list(input.projectId);
+                const projectId = input.project_id ?? ctx.currentProjectId;
+                if (!projectId) {
+                    return createErrorResult('No active project. Provide project_id or select a project.');
+                }
+                const items = await canvases.listByProject(projectId);
                 if (items.length === 0)
                     return createSuccessResult('No canvases yet.');
-                const lines = items.map((c) => `- [${c.type}] ${c.title}  (id: ${c.id})`);
+                const lines = items.map((c) => `- [${c.type}] ${c.title}  (id: ${String(c.id)})`);
                 return createSuccessResult([`${String(items.length)} canvas(es):`, ...lines].join('\n'));
             }
             catch (error) {
@@ -132,18 +143,18 @@ export function createCanvasTools(config) {
         inputSchema: {
             type: 'object',
             properties: {
-                canvasId: { type: 'string', description: 'Canvas id.' },
+                canvas_id: { type: 'number', description: 'Canvas id.' },
             },
-            required: ['canvasId'],
+            required: ['canvas_id'],
         },
         execute: async (input) => {
             try {
-                const c = await canvas.get(input.canvasId);
+                const c = await canvases.getById(input.canvas_id);
                 if (!c)
-                    return createErrorResult(`Canvas "${input.canvasId}" not found.`);
+                    return createErrorResult(`Canvas ${String(input.canvas_id)} not found.`);
                 const tc = truncateContent(c.content);
                 const output = `Canvas "${c.title}" (${c.type})\n` +
-                    `ID: ${c.id}\n` +
+                    `ID: ${String(c.id)}\n` +
                     `Controls: ${String(c.controls.controls.length)}\n\n` +
                     `--- content ---\n` +
                     tc.content;
@@ -163,16 +174,16 @@ export function createCanvasTools(config) {
         inputSchema: {
             type: 'object',
             properties: {
-                canvasId: { type: 'string', description: 'Canvas id.' },
+                canvas_id: { type: 'number', description: 'Canvas id.' },
             },
-            required: ['canvasId'],
+            required: ['canvas_id'],
         },
         execute: async (input) => {
             try {
-                const deleted = await canvas.delete(input.canvasId);
-                if (!deleted)
-                    return createErrorResult(`Canvas "${input.canvasId}" not found.`);
-                return createSuccessResult(`Deleted canvas "${deleted.title}"`);
+                const ok = await canvases.delete(input.canvas_id);
+                if (!ok)
+                    return createErrorResult(`Canvas ${String(input.canvas_id)} not found.`);
+                return createSuccessResult(`Deleted canvas ${String(input.canvas_id)}`);
             }
             catch (error) {
                 return createErrorResult(`Failed to delete canvas: ${error instanceof Error ? error.message : String(error)}`);

package/dist/platform/tools/index.js

@@ -55,7 +55,7 @@ export function createPlatformTools(config, options) {
     if (config.context.episodes) {
         tools.push(...createEpisodeTools(config));
     }
-    if (config.context.canvas) {
+    if (config.context.canvases) {
         tools.push(...createCanvasTools(config));
     }
     return tools;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.16.0",
+  "version": "0.17.1",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",