@agent-relay/factory 0.1.67 → 0.1.69

package/dist/dispatch/work-unit-identity.js

@@ -5,8 +5,15 @@ const NOTION_PAGE_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f
 /**
  * Provider-native identity for one issue, independent of whichever Relayfile
  * alias or local mount path surfaced it to Factory.
+ *
+ * A declared origin outranks the sense path: a Linear mirror of a GitHub issue
+ * carries a `/linear/...` path but is the same work unit as the GitHub issue,
+ * and must not get an identity of its own.
  */
 export function dispatchIssueIdentity(issue) {
+    const origin = githubOriginIdentity(issue.origin);
+    if (origin)
+        return `github:${origin}`;
     const github = githubLifecycleIdentity({ issue });
     if (github)
         return `github:${github}`;
@@ -37,4 +44,65 @@ export function dispatchNotionPageIdentity(pageId) {
 export function dispatchAgentIdentityKey(issue, role) {
     return `${DISPATCH_IDENTITY_VERSION}:${dispatchIssueIdentity(issue)}:${role}`;
 }
+/**
+ * The GitHub half of a declared origin, in exactly the spelling
+ * `githubLifecycleIdentity` emits for a GitHub-native path, so a mirror and
+ * the native row it mirrors produce one identical identity.
+ */
+const githubOriginIdentity = (origin) => {
+    if (origin?.provider !== 'github')
+        return undefined;
+    const owner = origin.owner.trim().toLowerCase();
+    // Some providers spell the origin repo `owner/repo`; the identity wants the
+    // bare name. Trimmed by prefix rather than by a regex built from `owner`,
+    // which would throw on an owner containing a regex metacharacter and take
+    // triage and dispatch down with it.
+    const rawRepo = origin.repo.trim().toLowerCase();
+    const repo = rawRepo.startsWith(`${owner}/`) ? rawRepo.slice(owner.length + 1) : rawRepo;
+    if (!owner || !repo || repo.includes('/'))
+        return undefined;
+    if (!Number.isSafeInteger(origin.number) || origin.number <= 0)
+        return undefined;
+    return `${owner}/${repo}#${origin.number}`;
+};
+/**
+ * The structured GitHub origin a surface declares in its provider payload
+ * (`source: { provider: 'github', owner, repo, number }`) — the same record
+ * `safety/factory-scope.ts` reads to recognise a `[factory]` GitHub mirror.
+ *
+ * Returns undefined for a native Linear issue, which has no upstream origin
+ * and is correctly identified by its own uuid.
+ */
+export function mirrorWorkUnitOrigin(issue) {
+    // A surface whose own path already names the GitHub issue is not a mirror —
+    // it identifies itself, and recording a redundant origin would widen every
+    // persisted IssueRef for nothing.
+    if (githubLifecycleIdentity({ issue: { uuid: '', key: '', path: issue.path } }))
+        return undefined;
+    return workUnitOriginFromRaw(issue.raw);
+}
+export function workUnitOriginFromRaw(raw) {
+    const source = asRecord(wrappedPayload(raw).source);
+    if (!source || stringValue(source.provider)?.toLowerCase() !== 'github')
+        return undefined;
+    const owner = stringValue(source.owner)?.trim() ?? '';
+    const rawRepo = stringValue(source.repo)?.trim() ?? '';
+    const repo = owner && rawRepo.toLowerCase().startsWith(`${owner.toLowerCase()}/`)
+        ? rawRepo.slice(owner.length + 1)
+        : rawRepo;
+    const number = typeof source.number === 'number' ? source.number : Number(source.number);
+    if (!owner || !repo || repo.includes('/'))
+        return undefined;
+    if (!Number.isSafeInteger(number) || number <= 0)
+        return undefined;
+    return { provider: 'github', owner, repo, number };
+}
+const wrappedPayload = (value) => {
+    const record = asRecord(value);
+    return asRecord(record?.payload) ?? record ?? {};
+};
+const asRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : undefined;
+const stringValue = (value) => typeof value === 'string' ? value : undefined;
 //# sourceMappingURL=work-unit-identity.js.map

package/dist/dispatch/work-unit-identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"work-unit-identity.js","sourceRoot":"","sources":["../../src/dispatch/work-unit-identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AAE5E,MAAM,yBAAyB,GAAG,qBAAqB,CAAA;AACvD,MAAM,cAAc,GAAG,iEAAiE,CAAA;AAExF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACnD,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IACjD,IAAI,MAAM;QAAE,OAAO,UAAU,MAAM,EAAE,CAAA;IAErC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IAC9B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,CAAC,GAAG,8BAA8B,CAAC,CAAA;IAC1G,4EAA4E;IAC5E,mEAAmE;IACnE,mDAAmD;IACnD,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,CAAA;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAA;IAClH,CAAC;IACD,OAAO,UAAU,SAAS,EAAE,CAAA;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAe,EACf,IAAuB;IAEvB,OAAO,GAAG,yBAAyB,IAAI,qBAAqB,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;AAC/E,CAAC"}
+{"version":3,"file":"work-unit-identity.js","sourceRoot":"","sources":["../../src/dispatch/work-unit-identity.ts"],"names":[],"mappings":"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"}

package/dist/fleet/create-fleet.d.ts

@@ -9,6 +9,12 @@ export interface CreateFleetOptions {
     cwd?: string;
     connectionPath?: string;
     previewConfig?: PreviewConfig;
+    /**
+     * Workspace identity the relay backend registers as (config `relay.agentName`).
+     * Relay-only; the internal backend has no workspace registration. Undefined
+     * leaves `RelayFleetClient`'s own default in place.
+     */
+    relayAgentName?: string;
 }
 export interface CreateFleetDeps {
     harnessClient?: HarnessDriverClientLike;

package/dist/fleet/create-fleet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-fleet.d.ts","sourceRoot":"","sources":["../../src/fleet/create-fleet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,CAAA;AAC/C,eAAO,MAAM,8BAA8B,kCAAkC,CAAA;AAE7E,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,uBAAuB,CAAA;IAGvC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CACxB;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIrF;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,EAAE,IAAI,GAAE,eAAoB,0CAqBvF"}
+{"version":3,"file":"create-fleet.d.ts","sourceRoot":"","sources":["../../src/fleet/create-fleet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,OAAO,CAAA;AAC/C,eAAO,MAAM,8BAA8B,kCAAkC,CAAA;AAE7E,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,uBAAuB,CAAA;IAGvC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CACxB;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIrF;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,EAAE,IAAI,GAAE,eAAoB,0CAsBvF"}

package/dist/fleet/create-fleet.js

@@ -24,6 +24,7 @@ export function createFleet(options = {}, deps = {}) {
     if (backend === 'relay') {
         return new RelayFleetClient({
             workspaceKey: deps.workspaceKey,
+            agentName: options.relayAgentName,
             env: deps.env,
             log: deps.logger ? (message) => deps.logger?.info?.(message) : undefined,
         });

package/dist/fleet/create-fleet.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-fleet.js","sourceRoot":"","sources":["../../src/fleet/create-fleet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAgC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAKvD,MAAM,CAAC,MAAM,8BAA8B,GAAG,+BAA+B,CAAA;AAqB7E,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC3E,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAChE,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAA4B,EAC5B,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,kCAAkC,CAAC,QAAQ,CAAC,CAAA;QAC3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;QACpG,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,2EAA2E;IAC3E,wDAAwD;IACxD,OAAO,kCAAkC,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE,EAAE,OAAwB,EAAE;IACtF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAA;IAE7C,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,gBAAgB,CAAC;YAC1B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;SACzE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,IAAI,mBAAmB,CAAC;QAC7B,MAAM,EAAE,IAAI,CAAC,aAAa;QAC1B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,6BAA6B,EAAE,oCAAoC,CAAC,IAAI,CAAC,6BAA6B,CAAC;QACvG,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"create-fleet.js","sourceRoot":"","sources":["../../src/fleet/create-fleet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAgC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAKvD,MAAM,CAAC,MAAM,8BAA8B,GAAG,+BAA+B,CAAA;AA2B7E,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC3E,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAChE,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAA4B,EAC5B,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,kCAAkC,CAAC,QAAQ,CAAC,CAAA;QAC3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;QACpG,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,2EAA2E;IAC3E,wDAAwD;IACxD,OAAO,kCAAkC,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE,EAAE,OAAwB,EAAE;IACtF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAA;IAE7C,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,gBAAgB,CAAC;YAC1B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,OAAO,CAAC,cAAc;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;SACzE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,IAAI,mBAAmB,CAAC;QAC7B,MAAM,EAAE,IAAI,CAAC,aAAa;QAC1B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,6BAA6B,EAAE,oCAAoC,CAAC,IAAI,CAAC,6BAA6B,CAAC;QACvG,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAA;AACJ,CAAC"}

package/dist/fleet/relay-fleet-client.d.ts

@@ -32,6 +32,10 @@ export interface RelayFleetClientOptions {
     agentToken?: string;
     /** Workspace agent identity the factory registers/rotates for itself. */
     agentName?: string;
+    /** Recorded on the takeover audit row; set it to the real node where known. */
+    nodeId?: string;
+    /** Injectable for tests; the takeover endpoint is not on the SDK surface. */
+    fetch?: typeof globalThis.fetch;
     /** Stable workspace action used for durable agent lifecycle reports. */
     lifecycleActionName?: string;
     /** Engine base URL override. Absent means the SDK default (cast.agentrelay.com). */
@@ -57,6 +61,7 @@ export interface RelayFleetClientOptions {
     sleep?: (ms: number) => Promise<void>;
     log?: (message: string) => void;
 }
+export declare const MAX_REGISTRATION_ATTEMPTS = 10;
 export declare const DEFAULT_LIFECYCLE_ACTION_NAME = "factory.lifecycle";
 /**
  * A placement call that outlived the operation's remaining budget (#306).
@@ -85,6 +90,14 @@ export declare class RelayFleetClient implements FleetClient {
     readonly placementLocality: "remote";
     readonly durableOwnership = true;
     readonly lifecycleActionName: string;
+    /**
+     * Workspace identity this client registers as, after defaulting.
+     *
+     * Exposed read-only so a caller (and its tests) can confirm which identity a
+     * given configuration actually resolved to. Registration reads `#agentName`
+     * directly; this changes nothing about it.
+     */
+    get agentName(): string;
     constructor(options?: RelayFleetClientOptions);
     /** Agents spawned through this client that have not exited or been released. */
     trackedAgents(): ReadonlyMap<string, TrackedAgent>;
@@ -132,5 +145,15 @@ export declare class RelayFleetClient implements FleetClient {
     onAgentExit(listener: AgentExitListener): () => void;
     dispose(): Promise<void>;
 }
+/**
+ * Registration could not converge on a usable agent identity. Named so a
+ * six-day silent 409 loop surfaces as one actionable failure instead.
+ */
+export declare class FactoryAgentRegistrationError extends Error {
+    readonly agentName: string;
+    constructor(agentName: string, detail: string, options?: {
+        cause?: unknown;
+    });
+}
 export {};
 //# sourceMappingURL=relay-fleet-client.d.ts.map

package/dist/fleet/relay-fleet-client.d.ts.map

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

package/dist/fleet/relay-fleet-client.js

@@ -4,6 +4,18 @@ const knownCapabilities = new Set(['spawn:claude', 'spawn:codex', 'workflow:run'
 const openStatuses = new Set(['pending', 'dispatched', 'invoked']);
 const terminalStatuses = new Set(['completed', 'failed', 'denied']);
 const DEFAULT_AGENT_NAME = 'factory';
+// A backstop against an unbounded re-registration loop, not a tight retry
+// budget: a name conflict already fails immediately, so this only bounds
+// *consecutive* transient failures and is deliberately forgiving of a cold
+// start against a slow relay.
+export const MAX_REGISTRATION_ATTEMPTS = 10;
+// Matches the default @agent-relay/sdk resolves when no baseUrl is configured,
+// so a takeover always targets the host the register went to.
+const DEFAULT_RELAY_BASE_URL = 'https://cast.agentrelay.com';
+// Every engine status that means somebody is holding the identity. `offline` is
+// the only one that is not here, and `unknown` is what the SDK substitutes when
+// status is missing — so an absent status never reads as safe.
+const LIVE_AGENT_STATUSES = new Set(['online', 'active', 'idle', 'blocked', 'waiting', 'unknown']);
 export const DEFAULT_LIFECYCLE_ACTION_NAME = 'factory.lifecycle';
 const DEFAULT_SPAWN_ACK_TIMEOUT_MS = 5 * 60_000;
 const DEFAULT_POLL_INTERVAL_MS = 1_000;
@@ -56,6 +68,11 @@ export class RelayFleetClient {
     lifecycleActionName;
     #options;
     #agentName;
+    // The token minted by this process's own registration. Reused across
+    // bootstrap retries so a failure *after* registration never re-registers
+    // the same name — see #registerFactoryAgent (factory#316).
+    #registeredAgentToken;
+    #registrationAttempts = 0;
     #spawnAckTimeoutMs;
     #pollIntervalMs;
     #exitWatchIntervalMs;
@@ -85,6 +102,16 @@ export class RelayFleetClient {
     #watchTimer;
     #reconciling;
     #pendingReleaseRetry;
+    /**
+     * Workspace identity this client registers as, after defaulting.
+     *
+     * Exposed read-only so a caller (and its tests) can confirm which identity a
+     * given configuration actually resolved to. Registration reads `#agentName`
+     * directly; this changes nothing about it.
+     */
+    get agentName() {
+        return this.#agentName;
+    }
     constructor(options = {}) {
         this.#options = options;
         this.#agentName = options.agentName ?? DEFAULT_AGENT_NAME;
@@ -504,8 +531,14 @@ export class RelayFleetClient {
         if (!workspaceKey && !agentToken) {
             throw new Error('RelayFleetClient requires a workspace key (rk_live_…) or agent token (at_live_…); set RELAY_WORKSPACE_KEY or RELAY_AGENT_TOKEN');
         }
+        // Registration is not idempotent: the engine answers a repeat of a name it
+        // already holds with 409 agent_already_exists. Reusing the token this
+        // process already minted is what keeps a post-registration bootstrap
+        // failure from colliding with our own record (factory#316).
+        agentToken ??= this.#registeredAgentToken;
         if (!agentToken) {
             agentToken = await this.#registerFactoryAgent(workspaceKey);
+            this.#registeredAgentToken = agentToken;
         }
         const relay = this.#createRelay({
             ...(workspaceKey ? { workspaceKey } : {}),
@@ -515,17 +548,39 @@ export class RelayFleetClient {
         this.#messaging = relay.messaging;
         return this.#messaging;
     }
-    // Rotate-on-start is idempotent and leaves nothing secret on disk: the
-    // factory adopts its standing workspace identity and mints a fresh token.
+    // Mints this process's agent identity from the workspace key.
+    //
+    // `registerOrRotate`/`registerOrGet` used to recover from a name conflict by
+    // rotating the existing agent's token. In @relaycast/sdk 8.2.0 both became
+    // deprecated aliases for plain `register`, and the engine simultaneously
+    // closed the rotate path to workspace keys, so a conflict stopped being
+    // recoverable. Because the methods still *exist*, an optional-chain fallback
+    // never fires — the client just kept re-registering into 409 forever
+    // (factory#316). Call `register` directly, and reclaim the name by audited
+    // takeover when it is already held.
     async #registerFactoryAgent(workspaceKey) {
+        this.#registrationAttempts += 1;
+        if (this.#registrationAttempts > MAX_REGISTRATION_ATTEMPTS) {
+            throw new FactoryAgentRegistrationError(this.#agentName, `gave up after ${MAX_REGISTRATION_ATTEMPTS} registration attempts`);
+        }
         const bootstrap = this.#createRelay({
             workspaceKey,
             ...(this.#options.baseUrl ? { baseUrl: this.#options.baseUrl } : {}),
         });
         const agents = bootstrap.messaging.agents;
-        const register = agents.registerOrRotate?.bind(agents) ?? agents.register.bind(agents);
-        const registration = await register({ name: this.#agentName });
-        return registration.token;
+        try {
+            const registration = await agents.register({ name: this.#agentName });
+            this.#registrationAttempts = 0;
+            return registration.token;
+        }
+        catch (error) {
+            // Re-registering is what looped for six days. The only way out is to
+            // reclaim the record we collided with — or to fail by name.
+            if (isAgentNameConflictError(error)) {
+                return await this.#reclaimFactoryAgent(workspaceKey, agents, error);
+            }
+            throw error;
+        }
     }
     /** The wall-clock instant one placement operation must be finished by. */
     #operationDeadline() {
@@ -626,6 +681,114 @@ export class RelayFleetClient {
             await this.#releaseLatePlacement(name, outcome.value);
         });
     }
+    // The name exists and we hold no token for it. `recover` cannot help: its
+    // three authorities are agent-token, origin-node and work-unit-proof, and a
+    // workspace key establishes none of them. `/takeover` is the engine's own
+    // workspace-admin escape hatch for exactly this, and it is gated by
+    // requireWorkspaceKey — the credential we already have. It is absent from the
+    // `@agent-relay/sdk` agents surface, so this calls the endpoint directly.
+    async #reclaimFactoryAgent(workspaceKey, agents, conflict) {
+        let lastError = conflict;
+        // The engine rejects a stale `expected_agent_id` with 409
+        // agent_identity_conflict; that means the record moved under us, so re-read
+        // it and try once more rather than treating it as terminal.
+        for (let attempt = 0; attempt < 2; attempt += 1) {
+            const existing = asRecord(await agents.get(this.#agentName).catch(() => undefined));
+            const agentId = readString(existing, 'id', 'agent_id', 'agentId');
+            if (!agentId) {
+                throw new FactoryAgentRegistrationError(this.#agentName, `name is taken but the record could not be read back: ${errorMessage(lastError)}`, { cause: lastError });
+            }
+            await this.#assertAgentNotLive(agents, existing);
+            try {
+                return await this.#takeOverAgent(workspaceKey, agentId);
+            }
+            catch (error) {
+                lastError = error;
+                if (isIdentityMovedError(error) && attempt === 0)
+                    continue;
+                if (error instanceof FactoryAgentRegistrationError)
+                    throw error;
+                throw new FactoryAgentRegistrationError(this.#agentName, `could not reclaim the existing identity: ${errorMessage(error)}`, { cause: error });
+            }
+        }
+        throw new FactoryAgentRegistrationError(this.#agentName, `could not reclaim the existing identity: ${errorMessage(lastError)}`, { cause: lastError });
+    }
+    // Seizing a name from a LIVE agent would strand its credential. Our case is a
+    // collision with our own dead record, but the guard is coded rather than
+    // assumed — the situation is not a safety property.
+    async #assertAgentNotLive(agents, existing) {
+        // Allow-list, not a deny-list. The engine also has active/idle/blocked/
+        // waiting, all of which mean someone is holding this identity, and
+        // `unknown` is what the SDK substitutes when status is missing. Only a
+        // record that says offline gets as far as the presence check.
+        const status = readString(existing, 'status');
+        if (status !== 'offline') {
+            throw new FactoryAgentRegistrationError(this.#agentName, `refusing to take over agent in status "${status ?? 'unknown'}"; another factory may still hold this identity`);
+        }
+        // Presence is the canonical liveness signal, and the agent record can be
+        // stale. Everything below fails CLOSED: only a presence row we actually
+        // read, for this agent, carrying a status we recognise as not-live, may
+        // authorise a seizure. A request that failed, a body we cannot parse, or a
+        // missing row is absence of evidence — not evidence of death.
+        //
+        // This asymmetry is deliberate. Refusing to boot costs us a recoverable
+        // outage of our own; seizing a live agent's credential strands another
+        // running process and takes the very token it would need to recover.
+        let presence;
+        try {
+            presence = await agents.presence();
+        }
+        catch (error) {
+            throw new FactoryAgentRegistrationError(this.#agentName, `could not read presence to confirm the agent is not live: ${errorMessage(error)}`, { cause: error });
+        }
+        if (!Array.isArray(presence)) {
+            throw new FactoryAgentRegistrationError(this.#agentName, 'presence did not return a list, so the agent cannot be confirmed offline');
+        }
+        const entry = presence
+            .map((row) => asRecord(row))
+            .find((row) => readString(row, 'agentName', 'agent_name', 'name') === this.#agentName);
+        if (!entry) {
+            throw new FactoryAgentRegistrationError(this.#agentName, 'presence does not list this agent, so it cannot be confirmed offline');
+        }
+        const seenStatus = readString(entry, 'status');
+        if (seenStatus === undefined) {
+            throw new FactoryAgentRegistrationError(this.#agentName, 'presence reported no status for this agent, so it cannot be confirmed offline');
+        }
+        if (LIVE_AGENT_STATUSES.has(seenStatus)) {
+            throw new FactoryAgentRegistrationError(this.#agentName, `presence reports this agent as "${seenStatus}"; another factory may still hold this identity`);
+        }
+    }
+    async #takeOverAgent(workspaceKey, expectedAgentId) {
+        const base = (this.#options.baseUrl ?? DEFAULT_RELAY_BASE_URL).replace(/\/+$/, '');
+        const url = `${base}/v1/agents/${encodeURIComponent(this.#agentName)}/takeover`;
+        const doFetch = this.#options.fetch ?? globalThis.fetch;
+        // Every field lands in the audit row, so make them all say something.
+        const response = await doFetch(url, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${workspaceKey}`, 'content-type': 'application/json' },
+            body: JSON.stringify({
+                expected_agent_id: expectedAgentId,
+                actor: `factory:${this.#agentName}`,
+                reason: 'factory bootstrap reclaiming its own workspace identity after a registration conflict (factory#316)',
+                session_ref: `factory-bootstrap-${this.#now()}`,
+                node_id: this.#options.nodeId ?? 'factory-cloud-container',
+            }),
+        });
+        const payload = asRecord(await response.json().catch(() => undefined));
+        if (!response.ok) {
+            const failure = asRecord(payload?.error);
+            const error = new Error(readString(failure, 'message') ?? `takeover failed with HTTP ${response.status}`);
+            error.code = readString(failure, 'code');
+            error.statusCode = response.status;
+            throw error;
+        }
+        const data = asRecord(payload?.data) ?? payload;
+        const token = readString(data, 'token');
+        if (!token)
+            throw new Error('takeover succeeded but returned no agent token');
+        this.#registrationAttempts = 0;
+        return token;
+    }
     /**
      * Poll an invocation to a terminal status inside `deadlineAtMs`.
      *
@@ -1077,6 +1240,44 @@ function previewReference(value, placementNode) {
         ...(node ? { node } : {}),
     };
 }
+/**
+ * Registration could not converge on a usable agent identity. Named so a
+ * six-day silent 409 loop surfaces as one actionable failure instead.
+ */
+export class FactoryAgentRegistrationError extends Error {
+    agentName;
+    constructor(agentName, detail, options) {
+        super(`Factory agent "${agentName}" could not register with the relay workspace: ${detail}`);
+        this.name = 'FactoryAgentRegistrationError';
+        this.agentName = agentName;
+        if (options && 'cause' in options) {
+            ;
+            this.cause = options.cause;
+        }
+    }
+}
+// The SDK reports the engine's 409 agent_already_exists as a RelayError with
+// `code: 'name_conflict'` and `rawCode: 'agent_already_exists'`. Match on the
+// structured fields first and keep the message probe for stubs and older SDKs.
+function isAgentNameConflictError(error) {
+    const record = asRecord(error);
+    if (record) {
+        if (record.rawCode === 'agent_already_exists' || record.code === 'name_conflict')
+            return true;
+        if (record.statusCode === 409 || record.status === 409)
+            return true;
+    }
+    return /already exists|name[ _]conflict|agent_already_exists/i.test(errorMessage(error));
+}
+// 409 agent_identity_conflict means the record moved between our read and the
+// takeover — retryable once, unlike agent_already_exists which is the conflict
+// we are already handling.
+function isIdentityMovedError(error) {
+    const record = asRecord(error);
+    if (record?.code === 'agent_identity_conflict')
+        return true;
+    return /agent_identity_conflict|no longer has expected id/i.test(errorMessage(error));
+}
 function isUnknownRecipientError(error) {
     const message = errorMessage(error);
     return /not[ _]found|unknown (agent|recipient)|no such (agent|recipient)|unregistered/i.test(message);