crewly 1.6.0 → 1.6.2

package/dist/backend/backend/src/services/ai/prompt-modules/role-boundary.module.js

@@ -37,12 +37,37 @@ export class RoleBoundaryModule {
      * @returns Formatted markdown role boundary section
      */
     async build(config) {
+        // === Fail-fast misconfiguration guards (WIRE-1 V4 + F-G) ===========
+        // (1) canDelegate=true && orgRole undefined → throw.
+        // A member who can delegate but whose orgRole was never resolved
+        // indicates the caller bypassed `buildModuleConfigFromTeamMember`.
+        // The previous silent `?? 'executor'` fallback caused every TL
+        // agent in production to render with the executor boundary —
+        // the bug this ticket fixes (Arch Veto #7).
+        if (config.canDelegate === true && config.orgRole === undefined) {
+            throw new Error(`RoleBoundaryModule: canDelegate=true but orgRole is undefined for ` +
+                `session=${config.sessionName ?? '<unknown>'}. ` +
+                `Resolve orgRole via deriveOrgRole(member, team) before assembly — ` +
+                `silent executor fallback is the bug WIRE-1 fixes (Arch Veto #7).`);
+        }
+        // (2) Symmetric misconfig (F-G): canDelegate=false && orgRole='team-lead'.
+        // Refuse to render TL authority for a member that cannot delegate.
+        if (config.canDelegate === false && config.orgRole === 'team-lead') {
+            throw new Error(`RoleBoundaryModule: canDelegate=false but orgRole='team-lead' for ` +
+                `session=${config.sessionName ?? '<unknown>'}. ` +
+                `Symmetric misconfiguration — refuse to render TL authority for a ` +
+                `member that cannot delegate (WIRE-1 F-G).`);
+        }
         // Try loading a custom role fragment first
         const fragment = loadRoleFragment(config.projectRoot, config.role, 'role-boundary');
         if (fragment) {
             return fragment + this.buildOrganizationContext(config);
         }
-        // Fall back to inline content based on orgRole (default: executor)
+        // Fall back to inline content based on orgRole. Default to 'executor'
+        // for non-TL members whose orgRole was not resolved — that path is
+        // correct (executor is the right boundary for plain workers) and not
+        // the bug we are fixing. The canDelegate=true case is gated above
+        // so it cannot reach this fallback silently.
         const orgRole = config.orgRole ?? 'executor';
         let boundary;
         switch (orgRole) {
@@ -162,11 +187,14 @@ export class RoleBoundaryModule {
             '',
             '### What You ARE',
             '- User secretary and message router',
-            '- Context compressor and status coordinator',
+            '- **Status translator**: condense multi-agent technical chatter into plain business-language updates the owner can act on',
+            '- **Decision packager**: when owner input is needed, deliver one clear question + context + recommendation, never raw analysis',
             '- Thread continuity manager',
             '- Notification and event router',
             '- Escalation handler and cross-team coordinator',
             '',
+            '**Note on "compression":** condensing means distilling what matters, NOT using shorthand or internal code names. A 3-line summary in plain English is correct compression; a 3-line summary packed with internal task IDs is wrong compression.',
+            '',
             '### What You Are NOT',
             '- Strategy maker or task decomposer (that\'s the Team Lead)',
             '- Code writer or implementer (that\'s the Executor)',

package/dist/backend/backend/src/services/ai/prompt-modules/role-boundary.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"role-boundary.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/role-boundary.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"role-boundary.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/role-boundary.module.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAalD;;OAEG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA0DzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,kBAAkB;IAyD1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB1B"}
+{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAalD;;OAEG;IACH,OAAO,CAAC,eAAe;IAqEvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA0DzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,kBAAkB;IAyD1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB1B"}

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js

@@ -48,6 +48,23 @@ export class SkillsReferenceModule {
             '- `core/remember` — store knowledge for future reference',
             '- `core/record-learning` — record learnings while working',
             '- `core/report-status` — report status to team leader or orchestrator',
+            '',
+            '### Follow-up skills (ad-hoc timers and event watchers)',
+            '- `core/schedule-followup` — schedule a future check-in that creates a WorkItem at time T',
+            '    • one-shot: `--in-minutes N` or `--fire-at <ISO8601>`',
+            '    • bounded recurring: `--cron "<expr>" --max-fires N`',
+            '    • target yourself (default) or another agent via `--target`',
+            '- `core/watch-for-event` — fire a WorkItem whenever an event occurs (e.g. `agent:idle`, `task:completed`)',
+            '    • narrow with `--filter-session <session>` or `--filter-json \'{"...":"..."}\'`',
+            '    • cap with `--max-fires` / `--max-idle-fires` so a flapping source does not loop forever',
+            '- `core/cancel-followup` — cancel a trigger you created (`--id` or `--name`)',
+            '- `core/list-my-followups` — list follow-ups owned by your team (audit before adding a new one)',
+            '',
+            '**Follow-up discipline (required):**',
+            '1. Every follow-up must have a **finite end**. Use `maxFires` for recurring, or rely on the default `maxIdleFires=3` auto-cancel.',
+            '2. Call `cancel-followup` the moment you confirm the task is done — do not rely on idle-auto-cancel as your only safety net.',
+            '3. Before scheduling a new watcher on a target, run `list-my-followups --name-prefix watch:` to avoid duplicates.',
+            '4. Prefer `watch-for-event` when you need reactive coverage (agent went idle → check). Prefer `schedule-followup` when you need a wall-clock checkpoint (9am tomorrow → re-prompt).',
         ];
         // Orchestrators and TLs get additional coordination skills
         if (config.role === 'orchestrator') {

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/ai/prompt-modules/sop-norm-distinction.module.d.ts

@@ -0,0 +1,79 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * SOP-vs-Norm distinction module — teaches every agent how to differentiate
+ * procedural SOPs (step-by-step deliverable guides) from behavioral Norms
+ * (collaboration covenants applied as constraints), how to name and place
+ * new SOP / Norm docs, how to reconcile conflicting versions, and how to
+ * communicate with task owners (silent-by-default / outcomes-first /
+ * thread-scope-discipline).
+ *
+ * This module sits at v1.5 of the three-tier knowledge-reconciliation
+ * roadmap:
+ *   - v1   (Mia, shipped): Karpathy-lite — `record-learning` entity-centric format.
+ *   - v1.5 (this module):  prompt-layer SOP/Norm classification + naming + reconciliation hint.
+ *   - v2   (Archivist, deferred): full cross-artifact synthesis engine.
+ *
+ * Reconciliation is treated as a horizontal primitive across all knowledge
+ * artifacts. v1.5 is the prompt-layer hint only — it does NOT introduce a
+ * service. It teaches agents to recognise conflict and escalate to TL,
+ * never silently merge.
+ *
+ * Source of truth for SOP/Norm classification:
+ *   YAML frontmatter `type: sop | norm | hybrid` on each doc file.
+ *   Filename prefix (`sop-*` / `norm-*` / `hybrid-*`) is a secondary hint.
+ *
+ * Owner Communication Discipline (3 norms folded as one family):
+ *   - Silent by default
+ *   - Deliver outcomes, not narrate progress
+ *   - Thread scope discipline
+ * The three propagate via this module's system-prompt injection so they
+ * apply to ALL agents, not just orchestrator agent memory.
+ *
+ * Spec source:
+ *   `.crewly/tasks/autonomy_v1/follow-up/sop-norm-prompt-module.md`
+ *   (orc relay 2026-04-26 evening; Steve directive on naming + placement +
+ *   reconciliation rules + Owner Communication Discipline.)
+ *
+ * @module services/ai/prompt-modules/sop-norm-distinction.module
+ */
+export declare class SOPNormDistinctionModule implements PromptModule {
+    name: string;
+    /** Just after `learning_references` (priority 10) so the SOP/Norm lens is established before downstream behavioural sections. */
+    priority: number;
+    /**
+     * Soft cap. Note: the spec acceptance criterion lists "Token estimate < 450"
+     * but that estimate undercounts the verbatim skeleton — once all 6 required
+     * sections (Definitions, Reading rules, Naming + placement, Reconciliation,
+     * Owner Communication Discipline, Why this matters) plus their mandated
+     * sub-items are rendered, the actual content measures ~1009 tokens. The
+     * authoritative budget is therefore raised to 1100 (≈9% headroom). Module is
+     * `compactable = true` so the assembler still trims under budget pressure.
+     * Deviation logged in spec follow-up; spec's "Token estimate < 450" line is
+     * acknowledged as an undercount, not enforced.
+     */
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always include — every agent (orchestrator, TL, executor) needs the
+     * SOP-vs-Norm lens and the Owner Communication Discipline guard rails.
+     *
+     * @param _config - unused; included for interface symmetry.
+     * @returns always `true`.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the SOP-vs-Norm distinction section as a markdown string.
+     * Output structure (6 sections, per spec acceptance criteria):
+     *   1. Definitions (SOP / Team Norm / Hybrid).
+     *   2. Reading rules (4 items).
+     *   3. Naming + placement rules (4 items).
+     *   4. Reconciliation rules (4 items, "extend not replace").
+     *   5. Owner Communication Discipline (3 norms as one family).
+     *   6. Why this matters.
+     *
+     * @param _config - unused; module content is static.
+     * @returns markdown section.
+     */
+    build(_config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=sop-norm-distinction.module.d.ts.map

package/dist/backend/backend/src/services/ai/prompt-modules/sop-norm-distinction.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop-norm-distinction.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/sop-norm-distinction.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,wBAAyB,YAAW,YAAY;IAC5D,IAAI,SAA0B;IAC9B,iIAAiI;IACjI,QAAQ,SAAM;IACd;;;;;;;;;;OAUG;IACH,SAAS,SAAQ;IACjB,WAAW,UAAQ;IAEnB;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;;;;;;;OAYG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAuCnD"}

package/dist/backend/backend/src/services/ai/prompt-modules/sop-norm-distinction.module.js

@@ -0,0 +1,118 @@
+/**
+ * SOP-vs-Norm distinction module — teaches every agent how to differentiate
+ * procedural SOPs (step-by-step deliverable guides) from behavioral Norms
+ * (collaboration covenants applied as constraints), how to name and place
+ * new SOP / Norm docs, how to reconcile conflicting versions, and how to
+ * communicate with task owners (silent-by-default / outcomes-first /
+ * thread-scope-discipline).
+ *
+ * This module sits at v1.5 of the three-tier knowledge-reconciliation
+ * roadmap:
+ *   - v1   (Mia, shipped): Karpathy-lite — `record-learning` entity-centric format.
+ *   - v1.5 (this module):  prompt-layer SOP/Norm classification + naming + reconciliation hint.
+ *   - v2   (Archivist, deferred): full cross-artifact synthesis engine.
+ *
+ * Reconciliation is treated as a horizontal primitive across all knowledge
+ * artifacts. v1.5 is the prompt-layer hint only — it does NOT introduce a
+ * service. It teaches agents to recognise conflict and escalate to TL,
+ * never silently merge.
+ *
+ * Source of truth for SOP/Norm classification:
+ *   YAML frontmatter `type: sop | norm | hybrid` on each doc file.
+ *   Filename prefix (`sop-*` / `norm-*` / `hybrid-*`) is a secondary hint.
+ *
+ * Owner Communication Discipline (3 norms folded as one family):
+ *   - Silent by default
+ *   - Deliver outcomes, not narrate progress
+ *   - Thread scope discipline
+ * The three propagate via this module's system-prompt injection so they
+ * apply to ALL agents, not just orchestrator agent memory.
+ *
+ * Spec source:
+ *   `.crewly/tasks/autonomy_v1/follow-up/sop-norm-prompt-module.md`
+ *   (orc relay 2026-04-26 evening; Steve directive on naming + placement +
+ *   reconciliation rules + Owner Communication Discipline.)
+ *
+ * @module services/ai/prompt-modules/sop-norm-distinction.module
+ */
+export class SOPNormDistinctionModule {
+    name = 'sop_norm_distinction';
+    /** Just after `learning_references` (priority 10) so the SOP/Norm lens is established before downstream behavioural sections. */
+    priority = 11;
+    /**
+     * Soft cap. Note: the spec acceptance criterion lists "Token estimate < 450"
+     * but that estimate undercounts the verbatim skeleton — once all 6 required
+     * sections (Definitions, Reading rules, Naming + placement, Reconciliation,
+     * Owner Communication Discipline, Why this matters) plus their mandated
+     * sub-items are rendered, the actual content measures ~1009 tokens. The
+     * authoritative budget is therefore raised to 1100 (≈9% headroom). Module is
+     * `compactable = true` so the assembler still trims under budget pressure.
+     * Deviation logged in spec follow-up; spec's "Token estimate < 450" line is
+     * acknowledged as an undercount, not enforced.
+     */
+    maxTokens = 1100;
+    compactable = true;
+    /**
+     * Always include — every agent (orchestrator, TL, executor) needs the
+     * SOP-vs-Norm lens and the Owner Communication Discipline guard rails.
+     *
+     * @param _config - unused; included for interface symmetry.
+     * @returns always `true`.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the SOP-vs-Norm distinction section as a markdown string.
+     * Output structure (6 sections, per spec acceptance criteria):
+     *   1. Definitions (SOP / Team Norm / Hybrid).
+     *   2. Reading rules (4 items).
+     *   3. Naming + placement rules (4 items).
+     *   4. Reconciliation rules (4 items, "extend not replace").
+     *   5. Owner Communication Discipline (3 norms as one family).
+     *   6. Why this matters.
+     *
+     * @param _config - unused; module content is static.
+     * @returns markdown section.
+     */
+    async build(_config) {
+        return `## SOP vs Team Norm — How to Read, Create, and Reconcile Procedure Docs
+
+### Definitions
+- **SOP** (Standard Operating Procedure): A step-by-step procedure to produce a specific deliverable. Follow it sequentially. Examples: code-commit-sop, content-production-pipeline.
+- **Team Norm**: A behavioral / collaboration covenant with teammates. Apply it as a constraint on *how* you work, not as steps to execute. Examples: branch-guard rule, worktree-isolation pattern.
+- **Hybrid**: A doc containing both. Identify which sections are procedural (follow steps) vs which are normative (apply as constraint).
+
+### Reading rules
+1. **Source of truth = YAML frontmatter \`type:\`** on the doc file (\`sop\` | \`norm\` | \`hybrid\`).
+2. **Filename prefix** is secondary: \`sop-*.md\` → procedural, \`norm-*.md\` → behavioral.
+3. **When you call \`get-sops\` skill**: returned docs declare their type in the response. Do NOT step-through a Norm.
+4. **When in doubt**: ask the team-leader. Misreading a Norm as an SOP causes over-procedure; ignoring a Norm causes collaboration breakdown.
+
+### Naming + placement rules (when you create a new SOP / Norm)
+1. **Filename prefix:** \`sop-<name>.md\` for procedural, \`norm-<name>.md\` for behavioral, \`hybrid-<name>.md\` for mixed.
+2. **YAML frontmatter:** Every doc MUST start with \`---\\ntype: sop|norm|hybrid\\n---\` block. The frontmatter \`type:\` is the contract — filename prefix is a secondary cue.
+3. **Subdirectory:** place under \`sops/sops/\`, \`sops/norms/\`, or \`sops/hybrids/\` respectively.
+4. **Hybrid docs** must have section-level \`<!-- type: sop -->\` / \`<!-- type: norm -->\` HTML comments inside the body so consumers can split.
+
+### Reconciliation rules (when you encounter conflicting SOPs / Norms)
+1. **Flag, don't merge.** If two docs disagree on the same procedure or covenant, do NOT silently merge. Open a conflict marker (write a note + escalate to TL).
+2. **Escalate to team-leader.** TL owns reconciliation decisions. Only TL may declare which version is canonical.
+3. **Multiple-version coexistence priority** (when no TL decision yet): \`mtime\` (newest wins for procedural drift) → \`version:\` frontmatter field (explicit semver wins) → explicit \`owner:\` frontmatter (owner-declared canonical wins).
+4. **Never delete.** Conflicting docs stay on disk. Append \`status: deprecated\` to frontmatter of the losing version once TL decides; keep file for audit. Mirrors Norm v0.2 "extend not replace".
+
+### Owner Communication Discipline
+When you communicate with task owners (TL, PM, Steve, Orchestrator), apply these three norms together — they are one family: **owner attention discipline**.
+
+1. **Silent by default.** Do not surface what should not be surfaced. If a status update doesn't change a decision, don't send it. Heartbeats / "still working" pings are noise; only surface progress when (a) a milestone landed, (b) you are blocked, or (c) the owner asked for an update.
+2. **Deliver outcomes, not narrate progress.** When you do surface, lead with the conclusion + recommendation. Owners parse the first line; everything after is supporting evidence. Never bury the verdict at the bottom of a play-by-play.
+3. **Thread Scope Discipline.** Each Slack thread / message-context has its own topic scope. Replies stay within that scope — no cross-thread sidebars. ("By the way, X thread is also progressing…" is noise to the X-thread owner.) Cross-thread routing is the orchestrator's job; topic owners do not need sidebar updates from peer threads. Exception: owner explicitly asked "also tell me about X".
+
+### Why this matters
+- An SOP says "do X then Y then Z to ship a PR". Follow exactly.
+- A Norm says "always branch-guard before commit". Apply every time, not as a sequential step.
+- Silent merging of conflicting docs erases team-decision history. Always surface conflict, never resolve it implicitly.
+- Owner attention is finite. The three Owner Communication norms compound: silent-by-default reduces volume, outcomes-first reduces parse cost, thread-scope reduces context-switch cost.`;
+    }
+}
+//# sourceMappingURL=sop-norm-distinction.module.js.map

package/dist/backend/backend/src/services/ai/prompt-modules/sop-norm-distinction.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop-norm-distinction.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/sop-norm-distinction.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,wBAAwB;IACpC,IAAI,GAAG,sBAAsB,CAAC;IAC9B,iIAAiI;IACjI,QAAQ,GAAG,EAAE,CAAC;IACd;;;;;;;;;;OAUG;IACH,SAAS,GAAG,IAAI,CAAC;IACjB,WAAW,GAAG,IAAI,CAAC;IAEnB;;;;;;OAMG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,KAAK,CAAC,OAAqB;QAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0LAoCiL,CAAC;IAC1L,CAAC;CACD"}

package/dist/backend/backend/src/services/browser/browser-bridge.service.d.ts

@@ -59,7 +59,45 @@ export interface BrowserBridgeStatus {
     relayAvailable?: boolean;
     /** Cloud device ID of the relay-connected Extension (null if not discovered) */
     relayDeviceId?: string | null;
+    /** Number of currently active agent→tab bindings (per-tab dispatch). */
+    bindingCount?: number;
 }
+/**
+ * Per-tab dispatch (1 agent : 1 tab) — see
+ * `.crewly/specs/crewly-in-chrome-per-tab-fix-2026-04-25.md`.
+ *
+ * Each binding records which agentSession owns which Extension tab, plus
+ * a recency stamp used by the TTL sweep to evict idle bindings.
+ */
+export interface AgentTabBinding {
+    /** Owning agent session (`X-Agent-Session` header value). */
+    agentSession: string;
+    /** Chrome tab id this agent has been bound to. */
+    tabId: number;
+    /** Window id the tab lives in (tracked for cross-window heuristics). */
+    windowId?: number;
+    /** Wall-clock time when the binding was first established. */
+    boundAt: Date;
+    /** Wall-clock time of the last command that touched this binding. Reset on activity. */
+    lastActivityAt: Date;
+}
+/**
+ * Tab descriptor reported by the Extension during the post-reconnect
+ * inventory handshake (§4.4 Reconnect Reconciliation).
+ */
+export interface ExtensionTabDescriptor {
+    tabId: number;
+    url?: string;
+    title?: string;
+    windowId?: number;
+    /** True when the tab is in Crewly's tab group — only these are eligible for auto-close. */
+    crewlyOwned?: boolean;
+}
+/**
+ * Reasons a tab binding can disappear. Surfaced in logs/metrics so we
+ * can distinguish user-driven closes from sweep-driven evictions.
+ */
+export type AgentTabBindingRemovalReason = 'unbind' | 'tab_removed' | 'ttl_expired' | 'reconcile_extension_missing' | 'shutdown';
 /**
  * BrowserBridgeService manages WebSocket connections from the Crewly Chrome
  * Extension and provides a command-response bridge for the REST API layer.
@@ -73,6 +111,16 @@ export declare class BrowserBridgeService {
     private clients;
     private pendingCommands;
     private commandCounter;
+    /**
+     * Per-agent tab bindings (per-tab dispatch §3.2). Keyed by `agentSession`
+     * so each agent has at most one bound tab. Cleared on `unbindAgentTab`,
+     * tab-removed events from the Extension, TTL expiry, or shutdown.
+     */
+    private agentTabBindings;
+    /** Periodic timer that evicts idle bindings (§4.2). Only running while attached. */
+    private sweepTimer;
+    /** Last time we logged the soft-cap warning, used to throttle to once per sweep cycle. */
+    private softWarnLoggedAt;
     private constructor();
     /**
      * Get the singleton instance.
@@ -115,6 +163,119 @@ export declare class BrowserBridgeService {
      * @throws Error if no client is connected or command times out
      */
     sendCommand(tool: string, params?: Record<string, unknown>, timeoutMs?: number, agentName?: string): Promise<BrowserCommandResponse>;
+    /**
+     * Look up the current binding for an agent session, if any. Read-only —
+     * does NOT update `lastActivityAt`. Use `sendCommandForAgent` for the
+     * activity-tracking lookup path.
+     *
+     * @param agentSession `X-Agent-Session` header value.
+     * @returns The binding, or `undefined` if this agent has no bound tab.
+     */
+    getBinding(agentSession: string): AgentTabBinding | undefined;
+    /**
+     * Snapshot the current bindings as a plain array — used by `GET
+     * /api/browser/bindings` and by tests.
+     */
+    listBindings(): AgentTabBinding[];
+    /**
+     * Bind an agent to a fresh Chrome tab via the Extension. Idempotent: if
+     * the agent already has a binding, return it instead of creating a new
+     * tab (avoids tab leak when skill cache and backend disagree under
+     * concurrent calls).
+     *
+     * @param agentSession Owning agent session.
+     * @param opts.foreground Pass `active: true` to the Extension on create.
+     *   Defaults to `false` so the user's foreground tab is never disturbed.
+     * @param opts.timeoutMs Optional override for the create-tab WS round-trip.
+     * @returns The (possibly pre-existing) binding.
+     * @throws `Error` with a `tab_pool_full` cause when at hard cap.
+     */
+    bindAgentTab(agentSession: string, opts?: {
+        foreground?: boolean;
+        timeoutMs?: number;
+        agentName?: string;
+    }): Promise<AgentTabBinding>;
+    /**
+     * Release an agent's bound tab. Optionally instruct the Extension to
+     * close the tab as well (default: true). Safe to call when no binding
+     * exists — returns `{ released: false, tabClosed: false }` instead of
+     * throwing.
+     */
+    unbindAgentTab(agentSession: string, opts?: {
+        closeTab?: boolean;
+        reason?: AgentTabBindingRemovalReason;
+        timeoutMs?: number;
+    }): Promise<{
+        released: boolean;
+        tabClosed: boolean;
+    }>;
+    /**
+     * Send a command on behalf of an agent. Resolution priority (matches §4.2):
+     *
+     *   1. Explicit `tabId` in `params` — used as-is, NO ownership check
+     *      (legacy testing/debug only; controller layer is responsible for
+     *      enforcing cross-agent ownership rules before reaching here).
+     *   2. `agentSession` provided AND has a binding — inject bound tabId,
+     *      bump `lastActivityAt`.
+     *   3. `agentSession` provided AND no binding — auto-bind first, then
+     *      forward the original command with the new tabId.
+     *   4. No `agentSession` — pass through to plain `sendCommand` (active-tab
+     *      fallback in Extension, preserving backward compat).
+     *
+     * @param agentSession Owning agent session, or `undefined` for legacy fallback.
+     * @param tool Tool name (e.g. `navigate`, `read-text`).
+     * @param params Tool params; if it contains `tabId` we treat as explicit override.
+     * @param timeoutMs Optional command timeout.
+     * @param agentName Optional agent name for the Extension banner.
+     */
+    sendCommandForAgent(agentSession: string | undefined, tool: string, params?: Record<string, unknown>, timeoutMs?: number, agentName?: string): Promise<BrowserCommandResponse>;
+    /**
+     * Handle a `tabRemoved` event from the Extension (§4.3 — fires when
+     * the user manually closes a Crewly tab or when Chrome reaps it).
+     * Idempotent: tabs not in any binding are ignored.
+     */
+    handleTabRemoved(tabId: number): void;
+    /**
+     * Reconcile bindings against the Extension's current tab inventory
+     * (§4.4). Called whenever a fresh WS connection completes the post-
+     * reconnect handshake.
+     *
+     * - For each backend binding whose tabId no longer exists in the
+     *   Extension → drop the binding (`reconcile_extension_missing`).
+     * - For each Extension tab that is Crewly-owned but unknown to any
+     *   binding → ask the Extension to close it (orphan cleanup).
+     *
+     * Caller is responsible for actually sending the close commands; this
+     * method returns the orphan list rather than firing `unbindTab` itself
+     * to keep the function pure-ish and easier to test.
+     *
+     * @returns Orphan tabs the caller should close.
+     */
+    handleTabInventory(extensionTabs: ExtensionTabDescriptor[]): {
+        orphans: number[];
+    };
+    /** Effective hard cap, allowing env override `CREWLY_TAB_BIND_MAX`. */
+    private getTabPoolCap;
+    /** Effective TTL in ms, allowing env override `CREWLY_TAB_BIND_TTL_MINUTES`. */
+    private getTabBindingTtlMs;
+    /**
+     * Soft warning ping when bindings cross the warn threshold. Throttled
+     * to once per sweep cycle so we don't flood the logs during a burst.
+     */
+    private maybeWarnSoftCap;
+    /**
+     * Run the TTL sweep once. Idle bindings (`lastActivityAt + TTL < now`)
+     * are removed. Sends `unbindTab` to the Extension when a client is
+     * connected, but never fails the sweep on Extension errors.
+     *
+     * Exported via `runSweepOnce` for tests so we don't have to advance
+     * fake timers across the full 5-minute interval.
+     *
+     * @returns Number of bindings evicted in this pass.
+     */
+    runSweepOnce(): Promise<number>;
+    private startSweepTimer;
+    private stopSweepTimer;
     /**
      * Get the current bridge status, including relay availability.
      *

package/dist/backend/backend/src/services/browser/browser-bridge.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-bridge.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/browser/browser-bridge.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAmB,SAAS,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAIjD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC7B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,EAAE,EAAE,SAAS,CAAC;IACd,+BAA+B;IAC/B,WAAW,EAAE,IAAI,CAAC;IAClB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC9B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,sBAAsB;IACtC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IACnC,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IA0FpC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IA+BrB;;;;;;;;;;OAUG;IACG,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,GAAE,MAAoD,EAC/D,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,CAAC;IAsClC;;;;OAIG;IACH,SAAS,IAAI,mBAAmB;IA2BhC;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAiBtB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,IAAI,IAAI,IAAI;CA0BZ"}
+{"version":3,"file":"browser-bridge.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/browser/browser-bridge.service.ts"],"names":[],"mappings":"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"}