@compilr-dev/sdk 0.35.0 → 0.36.0

package/dist/index.d.ts

@@ -64,7 +64,7 @@ export { detectProject, suggestProjectType, detectCommon } from './detection/ind
 export type { DetectProjectOptions, DetectionResult, ContentSummary } from './detection/index.js';
 export { createGuideTool, SHARED_GUIDE_ENTRIES, searchGuideEntries, topicToGuideEntry, } from './guide/index.js';
 export type { GuideEntry, ContentTopic, ContentSection, GuideToolConfig } from './guide/index.js';
-export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createCanvasTools, createSceneTools, SCENE_TOOL_NAMES, createSceneWriter, SCENE_JOURNAL_SIZE, createImageTools, ProjectAnchorStore, FileArtifactService, } from './platform/index.js';
+export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createCanvasTools, createSceneTools, SCENE_TOOL_NAMES, resolveSelfAlias, createSceneWriter, SCENE_JOURNAL_SIZE, createImageTools, ProjectAnchorStore, FileArtifactService, } from './platform/index.js';
 export type { ProjectAnchorStoreConfig, FileArtifactServiceConfig, ImageToolsConfig, ImageResizer, } from './platform/index.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
 export type { CustomSkill, CompilrSkillExtension, ForkedFromMarker, InstalledFromMarker, SkillEligibilityContext, SkillCollision, SkillDiffLine, SkillValidationIssue, ScopeConfig, SkillResolution, } from './skills/index.js';

package/dist/index.js

@@ -147,7 +147,7 @@ export { createGuideTool, SHARED_GUIDE_ENTRIES, searchGuideEntries, topicToGuide
 // =============================================================================
 // Platform Tools (runtime — createPlatformTools factory + individual factories)
 // =============================================================================
-export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createCanvasTools, createSceneTools, SCENE_TOOL_NAMES, createSceneWriter, SCENE_JOURNAL_SIZE, createImageTools, ProjectAnchorStore, FileArtifactService, } from './platform/index.js';
+export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createCanvasTools, createSceneTools, SCENE_TOOL_NAMES, resolveSelfAlias, createSceneWriter, SCENE_JOURNAL_SIZE, createImageTools, ProjectAnchorStore, FileArtifactService, } from './platform/index.js';
 // =============================================================================
 // Platform Workflow (pure step-criteria logic)
 // =============================================================================

package/dist/platform/context.d.ts

@@ -47,9 +47,29 @@ export interface PlatformHooks {
         id: number;
         name: string;
     }) => void;
-    /** Resolve owner aliases (e.g., 'self' → active agent ID) */
+    /**
+     * Resolve owner aliases (e.g., 'self' → active agent ID).
+     *
+     * ⚠️ MUST read the agent executing RIGHT NOW, not the one that was active when the tools were
+     * built — platform tools are built once and memoised by every host, so a captured value freezes
+     * for the session. Same trap as `cwd`, below. Implement it with {@link resolveSelfAlias}.
+     */
     resolveOwner?: (alias: 'self') => string | undefined;
 }
+/**
+ * Turn a host's notion of "the agent running now" into an owner alias.
+ *
+ * `'default'` is the coordinator slot every single-agent session uses, not an identity, so it
+ * resolves to `undefined` — which callers then render as their own fallback (`'agent'` for a work
+ * item's author) rather than writing the literal string `default` into stored data.
+ *
+ * ⚠️ This lives here because BOTH hosts need the same answer and only one of them had it. The CLI
+ * implemented the rule inline; Desktop passed no `resolveOwner` at all, so every scene edit
+ * recorded no agent and `consumeUserEdits` keyed every agent on the empty string — one shared
+ * "already told" mark, so only the FIRST agent to touch a canvas was ever told about the user's
+ * edits to it. The rule being in one host and not the other is a bug in both.
+ */
+export declare function resolveSelfAlias(agentId: string | null | undefined): string | undefined;
 export interface PlatformToolsConfig {
     /** Data access layer */
     context: PlatformContext;

package/dist/platform/context.js

@@ -4,6 +4,24 @@
  * Provides a single entry point for data access, abstracting over the
  * underlying storage backend (SQLite in CLI, PostgreSQL in web/API).
  */
+/**
+ * Turn a host's notion of "the agent running now" into an owner alias.
+ *
+ * `'default'` is the coordinator slot every single-agent session uses, not an identity, so it
+ * resolves to `undefined` — which callers then render as their own fallback (`'agent'` for a work
+ * item's author) rather than writing the literal string `default` into stored data.
+ *
+ * ⚠️ This lives here because BOTH hosts need the same answer and only one of them had it. The CLI
+ * implemented the rule inline; Desktop passed no `resolveOwner` at all, so every scene edit
+ * recorded no agent and `consumeUserEdits` keyed every agent on the empty string — one shared
+ * "already told" mark, so only the FIRST agent to touch a canvas was ever told about the user's
+ * edits to it. The rule being in one host and not the other is a bug in both.
+ */
+export function resolveSelfAlias(agentId) {
+    if (!agentId || agentId === 'default')
+        return undefined;
+    return agentId;
+}
 /**
  * Resolve a `cwd` that may be a value or a getter.
  *

package/dist/platform/index.d.ts

@@ -5,6 +5,8 @@ export type { ProjectType, ProjectStatus, RepoPattern, WorkflowMode, LifecycleSt
 export type { IProjectRepository, IWorkItemRepository, IDocumentRepository, IPlanRepository, ICommentRepository, ICanvasRepository, } from './repositories.js';
 export type { IAnchorService, IArtifactService, IEpisodeService, ICanvasRenderer, RenderedCanvasImage, AnchorData, ArtifactType, ArtifactData, ArtifactSummaryData, WorkEpisode, ProjectWorkSummary, } from './services.js';
 export type { PlatformContext, PlatformToolsConfig, PlatformHooks } from './context.js';
+/** Owner-alias rule shared by every host — see its doc comment for why it lives here. */
+export { resolveSelfAlias } from './context.js';
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createCanvasTools, createSceneTools, SCENE_TOOL_NAMES, sceneOutline, createImageTools, } from './tools/index.js';
 export { createSceneWriter, SCENE_JOURNAL_SIZE } from './scene-writer.js';
 export type { ISceneWriter, SceneReadResult, SceneApplyResult, SceneCreateResult, SceneLastEdit, } from './scene-writer.js';

package/dist/platform/index.js

@@ -1,6 +1,8 @@
 /**
  * Platform — Repository interfaces, data models, tools, and workflow.
  */
+/** Owner-alias rule shared by every host — see its doc comment for why it lives here. */
+export { resolveSelfAlias } from './context.js';
 // Platform tools (runtime)
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createCanvasTools, createSceneTools, SCENE_TOOL_NAMES, sceneOutline, createImageTools, } from './tools/index.js';
 // The scene writer — one per host process, shared by the scene tools and the host's own

package/package.json

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