@moltzap/client 2026.811.0 → 2026.812.0

package/dist/moltzapd-registration.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Registry commit for a profile slot that has no identity yet.
+ *
+ * Registration is non-idempotent: the server generates the key and
+ * `agents.name` is unique, so a lost response requires a new agent name rather
+ * than a retry.
+ */
+import { Effect } from "effect";
+import { type RegisterAgentError } from "./auth.js";
+import { type ServiceConfigError } from "./config.js";
+import type { HarnessRegisterInput, HarnessRegisterResult } from "./harness/index.js";
+import type { DaemonPhaseState } from "./moltzapd-catalog.js";
+import { type ProfileName, type ProfileRecord } from "./profile.js";
+import type { ServiceRpcError } from "./service.js";
+/** The Registry call, the server address lookup, and the slot write. */
+export type CommitError = RegisterAgentError | ServiceConfigError | Error;
+/** A commit plus the activation it triggers. */
+export type RegistrationError = CommitError | ServiceRpcError;
+interface RegisterHandlerInput {
+    readonly name: ProfileName;
+    readonly record: ProfileRecord;
+    readonly phase: DaemonPhaseState;
+    readonly activation: Effect.Semaphore;
+    readonly activate: () => Effect.Effect<void, ServiceConfigError | ServiceRpcError>;
+    readonly onCatalogChanged: () => void;
+}
+/**
+ * Builds the `register` tool handler for a slot catalog.
+ * @param input Slot identity, phase holder, and the activation to run on commit.
+ * @param input.name Profile name owning the slot.
+ * @param input.record Slot record the commit writes back into.
+ * @param input.phase Current catalog state.
+ * @param input.activation Serializes commit with the activation it triggers.
+ * @param input.activate Transition to the active catalog.
+ * @param input.onCatalogChanged Announces the new catalog to open subscribers.
+ * @returns The registration handler.
+ */
+export declare const makeRegisterHandler: ({ name, record, phase, activation, activate, onCatalogChanged, }: RegisterHandlerInput) => (payload: HarnessRegisterInput) => Effect.Effect<HarnessRegisterResult, RegistrationError>;
+export {};
+//# sourceMappingURL=moltzapd-registration.d.ts.map

package/dist/moltzapd-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moltzapd-registration.d.ts","sourceRoot":"","sources":["../src/moltzapd-registration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,KAAK,CAAC;AAE1E,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,eAAe,CAAC;AAyC9D,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,CACpC,IAAI,EACJ,kBAAkB,GAAG,eAAe,CACrC,CAAC;IACF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,qEAQ3B,oBAAoB,eAEZ,oBAAoB,KAC5B,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,CAgBtD,CAAC"}

package/dist/moltzapd-registration.js

@@ -0,0 +1,59 @@
+/**
+ * Registry commit for a profile slot that has no identity yet.
+ *
+ * Registration is non-idempotent: the server generates the key and
+ * `agents.name` is unique, so a lost response requires a new agent name rather
+ * than a retry.
+ */
+import { Effect } from "effect";
+import { registerAgent } from "./auth.js";
+import { getHttpUrl, getServerUrl } from "./config.js";
+import { writeProfile, } from "./profile.js";
+const commitRegistration = ({ name, record, payload, }) => Effect.gen(function* () {
+    const httpUrl = yield* getHttpUrl;
+    const serverUrl = yield* getServerUrl;
+    const result = yield* registerAgent(httpUrl, record.agentName, {
+        ...(payload.inviteCode === undefined
+            ? {}
+            : { inviteCode: payload.inviteCode }),
+        ...(payload.description === undefined
+            ? {}
+            : { description: payload.description }),
+    });
+    // The slot keeps its name and port; commit only adds the identity pair.
+    yield* writeProfile(name, {
+        ...record,
+        agentId: result.agentId,
+        apiKey: result.apiKey,
+    });
+    // The key stays on disk. Callers get the identity and where to reach it.
+    return {
+        agentId: result.agentId,
+        agentName: record.agentName,
+        serverUrl,
+    };
+}).pipe(Effect.withSpan("moltzapd.register"));
+/**
+ * Builds the `register` tool handler for a slot catalog.
+ * @param input Slot identity, phase holder, and the activation to run on commit.
+ * @param input.name Profile name owning the slot.
+ * @param input.record Slot record the commit writes back into.
+ * @param input.phase Current catalog state.
+ * @param input.activation Serializes commit with the activation it triggers.
+ * @param input.activate Transition to the active catalog.
+ * @param input.onCatalogChanged Announces the new catalog to open subscribers.
+ * @returns The registration handler.
+ */
+export const makeRegisterHandler = ({ name, record, phase, activation, activate, onCatalogChanged, }) => (payload) => activation.withPermits(1)(Effect.gen(function* () {
+    if (phase.read().kind === "active") {
+        // eslint-disable-next-line agent-code-guard/effect-error-erasure -- Local MCP validation stays on the established broad Error boundary without adding a portable protocol error.
+        return yield* Effect.fail(new Error("This profile slot already has an agent identity"));
+    }
+    const result = yield* commitRegistration({ name, record, payload });
+    yield* activate();
+    // Clients holding an open subscription learn the catalog changed; any
+    // later tools/list re-reads the phase regardless.
+    onCatalogChanged();
+    return result;
+}).pipe(Effect.withSpan("makeRegisterHandler")));
+//# sourceMappingURL=moltzapd-registration.js.map

package/dist/moltzapd-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moltzapd-registration.js","sourceRoot":"","sources":["../src/moltzapd-registration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAA2B,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,YAAY,EAA2B,MAAM,aAAa,CAAC;AAMhF,OAAO,EACL,YAAY,GAGb,MAAM,cAAc,CAAC;AAetB,MAAM,kBAAkB,GAAG,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,OAAO,GACiB,EAGxB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE;QAC7D,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QACvC,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;KAC1C,CAAC,CAAC;IACH,wEAAwE;IACxE,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE;QACxB,GAAG,MAAM;QACT,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,yEAAyE;IACzE,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS;KACV,CAAC;AACJ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAchD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,CAAC,EACC,IAAI,EACJ,MAAM,EACN,KAAK,EACL,UAAU,EACV,QAAQ,EACR,gBAAgB,GACK,EAAE,EAAE,CAC3B,CACE,OAA6B,EAC4B,EAAE,CAC3D,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CACvB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnC,iLAAiL;QACjL,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAC7D,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACpE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClB,sEAAsE;IACtE,kDAAkD;IAClD,gBAAgB,EAAE,CAAC;IACnB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAChD,CAAC"}

package/dist/moltzapd.d.ts

@@ -4,35 +4,82 @@ import { type ServiceRpcError } from "./service.js";
 import type { ServiceConfigError } from "./config.js";
 interface MoltzapdOptions {
     readonly profileName: string;
-    readonly port: number;
 }
 type MoltzapdServer = Effect.Effect.Success<ReturnType<typeof acquireHarnessMcpHttpServer>>;
+/** Everything composing and running the daemon can fail with. */
+type DaemonError = Error | ServiceConfigError | ServiceRpcError;
+interface DaemonResourceScopes {
+    readonly activationScope: Scope.CloseableScope;
+    readonly daemonScope: Scope.CloseableScope;
+}
+/**
+ * Creates the daemon's nested resource owners. The activation scope is
+ * registered before the listener, so sequential LIFO shutdown closes the MCP
+ * listener before disconnecting the active channel core.
+ * @param parentScope Scope that owns the complete daemon lifetime.
+ * @returns Separate owners for the listener and activation resources.
+ * @internal
+ */
+export declare const makeDaemonResourceScopes: (parentScope: Scope.Scope) => Effect.Effect<DaemonResourceScopes>;
 /**
- * Owns one registered agent's service, channel core, network connection, and
- * guarded loopback MCP listener for the lifetime of the caller's scope.
+ * Runs one activation attempt in a child of the daemon scope.
+ *
+ * A successful attempt remains owned by the daemon. A failed or interrupted
+ * attempt closes completely before its error reaches the caller, so a later
+ * attempt cannot overlap a partial service, core, or network connection.
+ *
+ * @param daemonScope Scope owning a successful activation.
+ * @param attempt Scoped resources acquired by one activation attempt.
+ * @returns The attempt result after failed resources have been released.
+ * @internal
+ */
+export declare const runScopedActivationAttempt: <A, E>(daemonScope: Scope.Scope, attempt: Effect.Effect<A, E, Scope.Scope>) => Effect.Effect<A, E>;
+/**
+ * Owns one profile slot's loopback MCP listener for the lifetime of the
+ * caller's scope, plus the service, channel core, and network connection once
+ * that slot carries a Registry identity.
  *
  * ```mermaid
  * sequenceDiagram
  *   participant process as moltzapd
+ *   participant mcp as MCP listener
  *   participant service as MoltZapService
  *   participant core as MoltZapChannelCore
- *   participant mcp as MCP listener
  *
+ *   process->>mcp: listen(slot port) with the slot catalog
+ *   alt slot has no identity
+ *     mcp->>process: tools/call register
+ *     process->>process: commit identity into the slot
+ *   end
  *   process->>service: make(profileName)
  *   process->>core: construct(service)
  *   process->>core: install raw turn publisher
- *   process->>mcp: listen(port)
  *   process->>core: connect()
+ *   process->>mcp: serve the active catalog
  *   Note over core,mcp: Scope release closes MCP before disconnecting the core
  * ```
  *
- * The caller resolves the profile and port policy. This composition does not
- * start the Unix-socket server and does not expose its service or core.
+ * The slot itself carries the listener port, so no caller supplies one, and the
+ * listener binds before the identity exists — an unregistered slot is reachable
+ * at the same fixed `/mcp` URL as a registered one.
  *
- * @param options Existing profile name and caller-resolved listener port.
+ * @param options Existing profile name owning this daemon.
  * @returns The scoped loopback HTTP listener.
  * @internal
  */
-export declare const acquireMoltzapd: (options: MoltzapdOptions) => Effect.Effect<MoltzapdServer, Error | ServiceConfigError | ServiceRpcError, Scope.Scope>;
+export declare const acquireMoltzapd: (options: MoltzapdOptions) => Effect.Effect<MoltzapdServer, DaemonError, Scope.Scope>;
+/**
+ * Runs one agent daemon until the process runtime interrupts it.
+ *
+ * The process scope owns both the loopback MCP listener and the sole network
+ * connection. Interrupting the returned Effect closes the listener before
+ * disconnecting the agent transport.
+ *
+ * @param options Existing named profile owning this daemon.
+ * @param readySignal Effect that tells a supervising process this daemon owns
+ * its listener and, for a registered profile, its network connection.
+ * @returns A non-terminating daemon Effect whose scope closes on interruption.
+ */
+export declare const runMoltzapd: (options: MoltzapdOptions, readySignal: Effect.Effect<unknown, Error>) => Effect.Effect<never, DaemonError>;
 export {};
 //# sourceMappingURL=moltzapd.d.ts.map

package/dist/moltzapd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"moltzapd.d.ts","sourceRoot":"","sources":["../src/moltzapd.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAA2B,KAAK,EAAE,MAAM,QAAQ,CAAC;AAIhE,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAMtE,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,UAAU,eAAe;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAQD,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CACzC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAC/C,CAAC;AAqCF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,eAAe,YACjB,eAAe,KACvB,MAAM,CAAC,MAAM,CACd,cAAc,EACd,KAAK,GAAG,kBAAkB,GAAG,eAAe,EAC5C,KAAK,CAAC,KAAK,CA8BgC,CAAC"}
+{"version":3,"file":"moltzapd.d.ts","sourceRoot":"","sources":["../src/moltzapd.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAA2B,KAAK,EAAE,MAAM,QAAQ,CAAC;AAIhE,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AActE,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,UAAU,eAAe;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAOD,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CACzC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAC/C,CAAC;AAEF,iEAAiE;AACjE,KAAK,WAAW,GAAG,KAAK,GAAG,kBAAkB,GAAG,eAAe,CAAC;AA+BhE,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,cAAc,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,gBACtB,KAAK,CAAC,KAAK,KACvB,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAWiB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,EAAE,CAAC,eAChC,KAAK,CAAC,KAAK,WACf,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,KACxC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAakC,CAAC;AA+DxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,eAAe,YACjB,eAAe,KACvB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAaZ,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,YACb,eAAe,eACX,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,KACzC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAMK,CAAC"}

package/dist/moltzapd.js

@@ -2,22 +2,16 @@ import { Effect, ExecutionStrategy, Exit, Scope } from "effect";
 import packageJson from "../package.json" with { type: "json" };
 import { MoltZapChannelCore } from "./channel-core.js";
 import { acquireHarnessMcpHttpServer } from "./harness-mcp-server.js";
-import { makeHarnessMcpHttpHandlers } from "./harness-mcp-wire.js";
+import { makeHarnessMcpHttpHandler } from "./harness-mcp-wire.js";
+import { makeActiveTools, makeDaemonPhaseState, slotStatusHandler, } from "./moltzapd-catalog.js";
+import { makeRegisterHandler } from "./moltzapd-registration.js";
+import { isRegisteredProfile, parseProfileName, resolveProfileRecord, } from "./profile.js";
 import { MoltZapService } from "./service.js";
 const MCP_IMPLEMENTATION = {
     name: "moltzapd",
     version: packageJson.version,
 };
-const makeStatusHandler = (service, core) => () => Effect.succeed({
-    ...(service.ownAgentId === undefined
-        ? {}
-        : { agentId: service.ownAgentId }),
-    connected: core.isConnected(),
-    conversations: service.getConversations().length,
-});
-const acquireCore = (service) => 
-// eslint-disable-next-line agent-code-guard/acquire-release-requires-scope -- the process scope owns the sole core and its network connection
-Effect.acquireRelease(Effect.sync(() => new MoltZapChannelCore({ service })), (core) => core.disconnect());
+const acquireCore = (service) => Effect.acquireRelease(Effect.sync(() => new MoltZapChannelCore({ service })), (core) => core.disconnect());
 const installTurnPublisher = (core, publish) => {
     core.onRawInbound((messages) => Effect.sync(() => {
         const first = messages[0];
@@ -28,51 +22,129 @@ const installTurnPublisher = (core, publish) => {
     }));
 };
 /**
- * Owns one registered agent's service, channel core, network connection, and
- * guarded loopback MCP listener for the lifetime of the caller's scope.
+ * Creates the daemon's nested resource owners. The activation scope is
+ * registered before the listener, so sequential LIFO shutdown closes the MCP
+ * listener before disconnecting the active channel core.
+ * @param parentScope Scope that owns the complete daemon lifetime.
+ * @returns Separate owners for the listener and activation resources.
+ * @internal
+ */
+export const makeDaemonResourceScopes = (parentScope) => Effect.gen(function* () {
+    const daemonScope = yield* Scope.fork(parentScope, ExecutionStrategy.sequential);
+    const activationScope = yield* Scope.fork(daemonScope, ExecutionStrategy.sequential);
+    return { activationScope, daemonScope };
+}).pipe(Effect.withSpan("makeDaemonResourceScopes"));
+/**
+ * Runs one activation attempt in a child of the daemon scope.
+ *
+ * A successful attempt remains owned by the daemon. A failed or interrupted
+ * attempt closes completely before its error reaches the caller, so a later
+ * attempt cannot overlap a partial service, core, or network connection.
+ *
+ * @param daemonScope Scope owning a successful activation.
+ * @param attempt Scoped resources acquired by one activation attempt.
+ * @returns The attempt result after failed resources have been released.
+ * @internal
+ */
+export const runScopedActivationAttempt = (daemonScope, attempt) => Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
+    const attemptScope = yield* Scope.fork(daemonScope, ExecutionStrategy.sequential);
+    return yield* restore(attempt.pipe(Scope.extend(attemptScope))).pipe(Effect.onExit((exit) => Exit.isSuccess(exit) ? Effect.void : Scope.close(attemptScope, exit)));
+})).pipe(Effect.withSpan("runScopedActivationAttempt"));
+// Builds the transition from a committed slot to a serving agent. Each attempt
+// has its own child scope so a failed startup cannot leak partial resources
+// into the daemon lifetime.
+const makeActivator = ({ profileName, phase, activationScope }) => (publish) => runScopedActivationAttempt(activationScope, Effect.gen(function* () {
+    const service = yield* MoltZapService.make(profileName);
+    const core = yield* acquireCore(service);
+    installTurnPublisher(core, publish);
+    yield* core.connect();
+    phase.setActive(makeActiveTools(service, core));
+}));
+// Binds the slot's listener, then activates if the slot already carries an
+// identity. The listener comes first either way: registration has to be
+// reachable on a daemon that cannot yet build a service.
+const serveProfileSlot = (profileName, activationScope) => Effect.gen(function* () {
+    const name = yield* parseProfileName(profileName);
+    const record = yield* resolveProfileRecord(name);
+    const phase = makeDaemonPhaseState();
+    // Registration and initial activation share one transition lock so a live
+    // listener cannot begin another registration during startup.
+    const activation = yield* Effect.makeSemaphore(1);
+    const activate = makeActivator({ profileName, phase, activationScope });
+    const handler = makeHarnessMcpHttpHandler({
+        implementation: MCP_IMPLEMENTATION,
+        phase: phase.read,
+        slotStatus: slotStatusHandler,
+        register: makeRegisterHandler({
+            name,
+            record,
+            phase,
+            activation,
+            activate: () => activate(handler.publish),
+            onCatalogChanged: () => {
+                handler.notify.toolsChanged();
+            },
+        }),
+    });
+    const server = yield* acquireHarnessMcpHttpServer({
+        port: record.mcpPort,
+        handler,
+    });
+    if (isRegisteredProfile(record)) {
+        yield* activation.withPermits(1)(activate(handler.publish));
+    }
+    return server;
+});
+/**
+ * Owns one profile slot's loopback MCP listener for the lifetime of the
+ * caller's scope, plus the service, channel core, and network connection once
+ * that slot carries a Registry identity.
  *
  * ```mermaid
  * sequenceDiagram
  *   participant process as moltzapd
+ *   participant mcp as MCP listener
  *   participant service as MoltZapService
  *   participant core as MoltZapChannelCore
- *   participant mcp as MCP listener
  *
+ *   process->>mcp: listen(slot port) with the slot catalog
+ *   alt slot has no identity
+ *     mcp->>process: tools/call register
+ *     process->>process: commit identity into the slot
+ *   end
  *   process->>service: make(profileName)
  *   process->>core: construct(service)
  *   process->>core: install raw turn publisher
- *   process->>mcp: listen(port)
  *   process->>core: connect()
+ *   process->>mcp: serve the active catalog
  *   Note over core,mcp: Scope release closes MCP before disconnecting the core
  * ```
  *
- * The caller resolves the profile and port policy. This composition does not
- * start the Unix-socket server and does not expose its service or core.
+ * The slot itself carries the listener port, so no caller supplies one, and the
+ * listener binds before the identity exists — an unregistered slot is reachable
+ * at the same fixed `/mcp` URL as a registered one.
  *
- * @param options Existing profile name and caller-resolved listener port.
+ * @param options Existing profile name owning this daemon.
  * @returns The scoped loopback HTTP listener.
  * @internal
  */
 export const acquireMoltzapd = (options) => Effect.gen(function* () {
     const parentScope = yield* Effect.scope;
-    const daemonScope = yield* Scope.fork(parentScope, ExecutionStrategy.sequential);
-    const acquire = Effect.gen(function* () {
-        const service = yield* MoltZapService.make(options.profileName);
-        const core = yield* acquireCore(service);
-        const handlers = makeHarnessMcpHttpHandlers({
-            implementation: MCP_IMPLEMENTATION,
-            reply: core.sendReply.bind(core),
-            status: makeStatusHandler(service, core),
-        });
-        installTurnPublisher(core, handlers.active.publish);
-        const server = yield* acquireHarnessMcpHttpServer({
-            port: options.port,
-            registrationHandler: handlers.registration,
-            harnessHandler: handlers.active,
-        });
-        yield* core.connect();
-        return server;
-    }).pipe(Scope.extend(daemonScope));
+    const { activationScope, daemonScope } = yield* makeDaemonResourceScopes(parentScope);
+    const acquire = serveProfileSlot(options.profileName, activationScope).pipe(Scope.extend(daemonScope));
     return yield* acquire.pipe(Effect.onExit((exit) => Exit.isSuccess(exit) ? Effect.void : Scope.close(daemonScope, exit)));
 }).pipe(Effect.withSpan("acquireMoltzapd"));
+/**
+ * Runs one agent daemon until the process runtime interrupts it.
+ *
+ * The process scope owns both the loopback MCP listener and the sole network
+ * connection. Interrupting the returned Effect closes the listener before
+ * disconnecting the agent transport.
+ *
+ * @param options Existing named profile owning this daemon.
+ * @param readySignal Effect that tells a supervising process this daemon owns
+ * its listener and, for a registered profile, its network connection.
+ * @returns A non-terminating daemon Effect whose scope closes on interruption.
+ */
+export const runMoltzapd = (options, readySignal) => Effect.scoped(acquireMoltzapd(options).pipe(Effect.zipRight(readySignal), Effect.zipRight(Effect.never))).pipe(Effect.withSpan("runMoltzapd"));
 //# sourceMappingURL=moltzapd.js.map

package/dist/moltzapd.js.map

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

package/dist/notification/trace.d.ts

@@ -0,0 +1,10 @@
+import type { NotificationDelivery } from "@moltzap/protocol/rpc";
+import type { AnyNotificationDefinition } from "@moltzap/protocol/socket/catalog";
+/**
+ * Builds the stable diagnostic projection for one inbound notification.
+ * @param notification Notification delivered by the active socket client.
+ * @param agentId Agent receiving the notification when identity is available.
+ * @returns A JSON-safe trace record.
+ */
+export declare function notificationTraceRecord(notification: NotificationDelivery<AnyNotificationDefinition>, agentId?: string): Record<string, unknown>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/notification/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/notification/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AA8BlF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,oBAAoB,CAAC,yBAAyB,CAAC,EAC7D,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB"}

package/dist/notification/trace.js

@@ -0,0 +1,34 @@
+const isPlainRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const recordOrEmpty = (value) => isPlainRecord(value) ? value : {};
+const recordProperty = (record, key) => {
+    const value = record[key];
+    return isPlainRecord(value) ? value : undefined;
+};
+const stringProperty = (record, key) => {
+    const value = record[key];
+    return typeof value === "string" ? value : undefined;
+};
+const traceConversationId = (conversation, fallback) => conversation === undefined ? fallback : (conversation.id ?? fallback);
+/**
+ * Builds the stable diagnostic projection for one inbound notification.
+ * @param notification Notification delivered by the active socket client.
+ * @param agentId Agent receiving the notification when identity is available.
+ * @returns A JSON-safe trace record.
+ */
+export function notificationTraceRecord(notification, agentId) {
+    const params = recordOrEmpty(notification.params);
+    const message = recordProperty(params, "message");
+    const conversation = recordProperty(params, "conversation");
+    const notificationConversationId = stringProperty(params, "conversationId");
+    return {
+        ts: new Date().toISOString(),
+        agentId: agentId ?? "unknown",
+        notification: notification.method,
+        messageId: message?.id,
+        messageConversationId: message?.conversationId,
+        messageSenderId: message?.senderId,
+        conversationId: traceConversationId(conversation, notificationConversationId),
+        conversationName: conversation?.name,
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/notification/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/notification/trace.ts"],"names":[],"mappings":"AAGA,MAAM,aAAa,GAAG,CAAC,KAAc,EAAoC,EAAE,CACzE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,aAAa,GAAG,CAAC,KAAc,EAA2B,EAAE,CAChE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAEpC,MAAM,cAAc,GAAG,CACrB,MAA+B,EAC/B,GAAW,EAC0B,EAAE;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,MAA+B,EAC/B,GAAW,EACS,EAAE;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAC1B,YAAsC,EACtC,QAAiB,EACR,EAAE,CACX,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAA6D,EAC7D,OAAgB;IAEhB,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,0BAA0B,GAAG,cAAc,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5E,OAAO;QACL,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,OAAO,EAAE,OAAO,IAAI,SAAS;QAC7B,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,SAAS,EAAE,OAAO,EAAE,EAAE;QACtB,qBAAqB,EAAE,OAAO,EAAE,cAAc;QAC9C,eAAe,EAAE,OAAO,EAAE,QAAQ;QAClC,cAAc,EAAE,mBAAmB,CACjC,YAAY,EACZ,0BAA0B,CAC3B;QACD,gBAAgB,EAAE,YAAY,EAAE,IAAI;KACrC,CAAC;AACJ,CAAC"}

package/dist/presentation/index.d.ts

@@ -0,0 +1,3 @@
+/** @internal */
+export { PresentationState, type ConversationMeta, type CrossConversationEntry, type CrossConvMessage, } from "./state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/presentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC"}

package/dist/presentation/index.js

@@ -0,0 +1,3 @@
+/** @internal */
+export { PresentationState, } from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/presentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presentation/index.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,OAAO,EACL,iBAAiB,GAIlB,MAAM,YAAY,CAAC"}

package/dist/presentation/state.d.ts

@@ -0,0 +1,77 @@
+import type { ConversationCreatedNotification } from "@moltzap/protocol/conversation";
+import type { Message } from "@moltzap/protocol/message";
+import { Effect, HashMap } from "effect";
+/** Describes conversation meta. */
+export interface ConversationMeta {
+    id: string;
+    type: string;
+    name?: string;
+    participants: string[];
+}
+/** Structured summary of recent activity in one other conversation. */
+export interface CrossConversationEntry {
+    conversationId: string;
+    conversationName?: string;
+    senderName: string;
+    text: string;
+    minutesAgo: number;
+    /** Messages in this summary (capped by maxMessagesPerConv). */
+    count: number;
+}
+/** Full message from another conversation, used by peekFullMessages(). */
+export interface CrossConvMessage {
+    conversationId: string;
+    conversationName?: string;
+    senderName: string;
+    senderId: string;
+    text: string;
+    timestamp: string;
+}
+/** Immutable snapshots used while selecting cross-conversation context. */
+export interface CrossConvState {
+    readonly messagesMap: HashMap.HashMap<string, readonly Message[]>;
+    readonly conversationsMap: HashMap.HashMap<string, ConversationMeta>;
+    readonly agentNamesMap: HashMap.HashMap<string, string>;
+    readonly viewMarkers: HashMap.HashMap<string, string>;
+}
+type MessageTextRenderer = (message: Message) => string;
+interface AgentName {
+    readonly id: string;
+    readonly name: string;
+}
+/**
+ * Owns the service's in-memory presentation caches and viewer-scoped context
+ * markers. Network ingress and presentation rendering remain with the caller.
+ */
+export declare class PresentationState {
+    private readonly conversationsRef;
+    private readonly messagesRef;
+    private readonly agentNamesRef;
+    private readonly lastNotifiedRef;
+    reset(): Effect.Effect<void>;
+    getConversation(convId: string): ConversationMeta | undefined;
+    getConversations(): ConversationMeta[];
+    storeConversation(notification: ConversationCreatedNotification): void;
+    getHistory(convId: string, limit: number): Message[];
+    storeMessage(conversationId: string, message: Message): void;
+    getAgentName(agentId: string): string | undefined;
+    getAgentNames(): HashMap.HashMap<string, string>;
+    cacheAgentNames(agents: readonly AgentName[]): Effect.Effect<void>;
+    peekContextEntries(currentConvId: string, renderMessageText: MessageTextRenderer, opts: {
+        maxConversations?: number;
+        maxMessagesPerConv?: number;
+    }): {
+        entries: CrossConversationEntry[];
+        commit: () => void;
+    };
+    peekFullMessages(currentConvId: string, renderMessageText: MessageTextRenderer): {
+        messages: CrossConvMessage[];
+        commit: () => void;
+    };
+    private readCrossConvState;
+    private collectContextCandidates;
+    private iterNewMessagesByConv;
+    private advanceLastNotified;
+}
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/presentation/state.d.ts.map

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