@capxul/mcp 4.0.1 → 4.1.1

package/dist/main.mjs

@@ -4056,12 +4056,14 @@ const CAPXUL_OPERATIONS = {
 	},
 	activity: {
 		annotate: "activity.annotate",
+		emitAnnotationSaved: "activity.emitAnnotationSaved",
 		get: "activity.get",
 		list: "activity.list",
 		summary: "activity.summary"
 	},
 	addressBook: {
 		add: "addressBook.add",
+		emitRelationshipChanged: "addressBook.emitRelationshipChanged",
 		get: "addressBook.get",
 		hide: "addressBook.hide",
 		label: "addressBook.label",
@@ -4905,7 +4907,20 @@ const QuickPayExternalAddressAcknowledgedProps = Schema.Struct({
 	external_address_acknowledged: Schema.Literal(true),
 	organization_id: OptionalOrgId
 });
-const DepositInitiatedProps = Schema.Struct({ ...TelemetryEnvelopeProps });
+const DepositInitiatedProps = Schema.Struct({
+	...TelemetryEnvelopeProps,
+	scope_kind: Schema.optional(Schema.Literals(["account", "organization"])),
+	account_kind: Schema.optional(Schema.Literals(["personalSafe", "orgTreasury"])),
+	chain_id: Schema.optional(Schema.Number),
+	network: Schema.optional(Schema.Literal("base-sepolia")),
+	organization_id: OptionalOrgId,
+	$groups: Schema.optional(Schema.Struct({ organization: OptionalOrgId })),
+	actor_id: OptionalString,
+	actor_kind: Schema.optional(Schema.Literal("authenticated")),
+	distinct_id: OptionalString,
+	trace_id: OptionalString,
+	span_id: OptionalString
+});
 const DepositSettledProps = Schema.Struct({
 	...TelemetryEnvelopeProps,
 	chain_id: Schema.Number,
@@ -5143,6 +5158,148 @@ Schema.Struct({
 	name: Schema.Literal("movement_scan_incident"),
 	props: MovementScanIncidentProps
 });
+const ActivityReferenceProps = {
+	reference_kind: Schema.Literals(["payment", "movement"]),
+	reference_id: Schema.String
+};
+const ActivityFilterProps = {
+	filter_kind: Schema.optional(Schema.Literals([
+		"all",
+		"payment",
+		"movement"
+	])),
+	filter_direction: Schema.optional(Schema.Literals([
+		"all",
+		"in",
+		"out",
+		"self"
+	])),
+	filter_status: Schema.optional(Schema.Array(Schema.Literals([
+		"pending",
+		"settling",
+		"pending_claim",
+		"scheduled",
+		"streaming",
+		"settled",
+		"cancelled",
+		"failed"
+	])))
+};
+const ActivityActionProps = {
+	...TelemetryEnvelopeProps,
+	scope_kind: Schema.Literals(["account", "organization"]),
+	reason_code: Schema.optional(Schema.Literals(CAPXUL_ERROR_CODES))
+};
+Schema.Struct({
+	name: Schema.Literal("contact_relationship_changed"),
+	props: Schema.Struct({
+		...TelemetryEnvelopeProps,
+		change: Schema.Literals([
+			"added",
+			"renamed",
+			"hidden",
+			"restored"
+		]),
+		scope_kind: Schema.Literals(["account", "organization"]),
+		scope_id: Schema.String,
+		owner_party_id: Schema.String,
+		party_id: Schema.String,
+		hidden: Schema.Boolean,
+		occurred_at: Schema.Number,
+		operation: Schema.Literals([
+			CAPXUL_OPERATIONS.addressBook.add,
+			CAPXUL_OPERATIONS.addressBook.label,
+			CAPXUL_OPERATIONS.addressBook.hide,
+			CAPXUL_OPERATIONS.addressBook.unhide
+		])
+	})
+});
+const ContactActionProps = {
+	...TelemetryEnvelopeProps,
+	scope_kind: Schema.Literals(["account", "organization"]),
+	party_id: OptionalString,
+	reason_code: Schema.optional(Schema.Literals(CAPXUL_ERROR_CODES))
+};
+Schema.Struct({
+	name: Schema.Literal("ui_contact_action_completed"),
+	props: Schema.Union([
+		Schema.Struct({
+			...ContactActionProps,
+			action: Schema.Literal("add"),
+			outcome: Schema.Literals(["opened", "cancelled"])
+		}),
+		Schema.Struct({
+			...ContactActionProps,
+			action: Schema.Literal("refusal"),
+			outcome: Schema.Literal("displayed")
+		}),
+		Schema.Struct({
+			...ContactActionProps,
+			action: Schema.Literal("retry"),
+			outcome: Schema.Literal("requested")
+		})
+	])
+});
+Schema.Struct({
+	name: Schema.Literal("activity_annotation_saved"),
+	props: Schema.Struct({
+		...TelemetryEnvelopeProps,
+		...ActivityReferenceProps,
+		scope_kind: Schema.Literals(["account", "organization"]),
+		scope_id: Schema.String,
+		occurred_at: Schema.Number
+	})
+});
+Schema.Struct({
+	name: Schema.Literal("ui_activity_action_completed"),
+	props: Schema.Union([
+		Schema.Struct({
+			...ActivityActionProps,
+			...ActivityFilterProps,
+			action: Schema.Literal("filter"),
+			outcome: Schema.Literal("committed")
+		}),
+		Schema.Struct({
+			...ActivityActionProps,
+			action: Schema.Literal("refusal"),
+			outcome: Schema.Literal("displayed")
+		}),
+		Schema.Struct({
+			...ActivityActionProps,
+			action: Schema.Literal("retry"),
+			outcome: Schema.Literal("requested")
+		}),
+		Schema.Struct({
+			...ActivityActionProps,
+			...ActivityReferenceProps,
+			action: Schema.Literal("detail"),
+			outcome: Schema.Literals(["opened", "failed"])
+		}),
+		Schema.Struct({
+			...ActivityActionProps,
+			...ActivityReferenceProps,
+			action: Schema.Literal("receipt"),
+			outcome: Schema.Literals([
+				"document_rendered",
+				"explorer_opened",
+				"popup_blocked",
+				"failed"
+			])
+		}),
+		Schema.Struct({
+			...ActivityActionProps,
+			...ActivityFilterProps,
+			action: Schema.Literal("export"),
+			outcome: Schema.Literals([
+				"completed",
+				"partial",
+				"failed"
+			]),
+			row_count: Schema.optional(Schema.Number),
+			truncated: Schema.optional(Schema.Boolean)
+		})
+	])
+});
 function redactTelemetryProps(name, props, options = {}) {
 	if (props === void 0) return void 0;
 	const clone = cloneProps$1(props);
@@ -10176,6 +10333,23 @@ function observationOnlyControls(controls) {
 	const { signal: _signal, timeoutMs: _timeoutMs, deadlineMs: _deadlineMs, ...observation } = controls ?? {};
 	return copyInvocationObservation(controls, observation);
 }
+/** Project only SDK-owned facts. A caller Organization hint is not authority. */
+function verifiedOperationFields(attributes) {
+	const domain = {};
+	const organizationId = attributes.get("verified_organization_id");
+	if (typeof organizationId === "string" && safeEngineeringIdentifier(organizationId) !== void 0) domain.organization_id = organizationId;
+	for (const [key, allowed] of [
+		["scope_kind", ["account", "organization"]],
+		["account_kind", ["personalSafe", "orgTreasury"]],
+		["network", ["base-sepolia"]]
+	]) {
+		const value = attributes.get(key);
+		if (typeof value === "string" && allowed.some((candidate) => candidate === value)) domain[key] = value;
+	}
+	const chainId = attributes.get("chain_id");
+	if (typeof chainId === "number" && Number.isSafeInteger(chainId) && chainId > 0) domain.chain_id = chainId;
+	return domain;
+}
 /** Observe a public Effect that already uses the canonical CapxulError channel. */
 async function runCapxulEffect(effect, controls, operation = CAPXUL_OPERATIONS.runtime.port, runPromise = Effect.runPromise) {
 	const invocation = readInvocationObservation(controls);
@@ -10204,8 +10378,10 @@ async function runCapxulEffect(effect, controls, operation = CAPXUL_OPERATIONS.r
 		const error = Exit.isFailure(exit) ? Cause.squash(exit.cause) : void 0;
 		const failure = error instanceof CapxulError ? error : void 0;
 		const outcome = Exit.isSuccess(exit) ? "succeeded" : failure?.code === "CANCELLED" ? "cancelled" : failure !== void 0 && EXPECTED_OPERATION_OUTCOMES.has(failure.code) ? "refused" : "failed";
+		const span = yield* Effect.currentSpan.pipe(Effect.orDie);
 		const completion = {
 			...fields,
+			...verifiedOperationFields(span.attributes),
 			duration_ms,
 			outcome,
 			...failure === void 0 ? {} : { failure_code: failure.code },
@@ -11383,7 +11559,7 @@ const moneyExecutionContract = {
 };
 //#endregion
 //#region ../../packages/sdk/package.json
-var version$1 = "4.0.1";
+var version$1 = "4.1.1";
 //#endregion
 //#region ../../packages/sdk/src/telemetry/exception-projection.ts
 /** Fixed fallback for failures that have no safe message. */
@@ -11890,11 +12066,50 @@ function emitAccountBalanceFailed(telemetry, error) {
 		}
 	});
 }
-function emitDepositInitiated(telemetry) {
-	return emitMoneyTelemetry(telemetry, {
-		name: "deposit_initiated",
-		props: {}
-	});
+/** A successful authorized instruction read, not an incoming transfer. */
+function emitDepositInitiated(telemetry, instructions, source, verifiedOrganizationId) {
+	return Effect.gen(function* () {
+		const organizationId = safeEngineeringIdentifier(verifiedOrganizationId);
+		const fields = {
+			scope_kind: organizationId === void 0 ? "account" : "organization",
+			account_kind: organizationId === void 0 ? "personalSafe" : "orgTreasury",
+			...Number.isSafeInteger(instructions.chainId) && instructions.chainId > 0 ? { chain_id: instructions.chainId } : {},
+			...instructions.network === "base-sepolia" ? { network: instructions.network } : {},
+			...organizationId === void 0 ? {} : { verified_organization_id: organizationId }
+		};
+		yield* Effect.annotateCurrentSpan(fields);
+		if (telemetry === void 0) return;
+		const span = yield* Effect.currentSpan;
+		const snapshot = readInvocationObservation(source);
+		const { organizationId: _hint, ...context } = snapshot?.context ?? {};
+		const event = {
+			name: "deposit_initiated",
+			props: {
+				scope_kind: fields.scope_kind,
+				account_kind: fields.account_kind,
+				...fields.chain_id === void 0 ? {} : { chain_id: fields.chain_id },
+				...fields.network === void 0 ? {} : { network: fields.network },
+				$groups: organizationId === void 0 ? {} : { organization: organizationId },
+				...safeEngineeringIdentifier(snapshot?.actorId) === void 0 ? {} : {
+					actor_id: snapshot.actorId,
+					actor_kind: "authenticated",
+					distinct_id: snapshot.actorId
+				},
+				trace_id: span.traceId,
+				span_id: span.spanId,
+				...organizationId === void 0 ? {} : { organization_id: organizationId }
+			}
+		};
+		yield* telemetry.emit(snapshot === void 0 ? event : attachInvocationObservation(event, {
+			active: snapshot.active,
+			...snapshot?.actorId === void 0 ? {} : { actorId: snapshot.actorId },
+			context: {
+				...context,
+				...organizationId === void 0 ? {} : { organizationId },
+				traceparent: `00-${span.traceId}-${span.spanId}-01`
+			}
+		}));
+	}).pipe(Effect.catchCause(() => Effect.void));
 }
 function emitPaymentInitiated(telemetry, input) {
 	return emitMoneyTelemetry(telemetry, {
@@ -12510,7 +12725,10 @@ function makeFinancialOpsMethods(deps) {
 	return {
 		me: {
 			get: (options) => runIfActive(options?.signal, CAPXUL_OPERATIONS.me.get, () => deps.convexCall.query(fns.me, {})),
-			depositInstructions: (options) => runIfActive(options?.signal, CAPXUL_OPERATIONS.me.depositInstructions, () => deps.convexCall.query(fns.depositInstructions, {}).pipe(Effect.tap(() => Effect.promise(() => emitDepositInitiated(deps.telemetry)))))
+			depositInstructions: (options) => {
+				const controls = deps.invocationControls?.(options) ?? options;
+				return runPortEffect(Effect.suspend(() => deps.convexCall.query(fns.depositInstructions, copyInvocationObservation(controls, {}))).pipe(Effect.tap((instructions) => emitDepositInitiated(deps.telemetry, instructions, controls))), controls, CAPXUL_OPERATIONS.me.depositInstructions, deps.runPromise);
+			}
 		},
 		targets: { resolve: async (reference, options) => {
 			const recipient = normalizeTargetForBackend(reference, "reference");
@@ -12518,43 +12736,57 @@ function makeFinancialOpsMethods(deps) {
 			return mapOk(await runIfActive(options?.signal, CAPXUL_OPERATIONS.recipient.resolve, () => deps.convexCall.query(fns.resolveRecipient, { recipient: recipient.value })), resolvedTargetFromResolution);
 		} },
 		destinations: {
-			add: async (input, options) => {
-				const scope = normalizeDestinationInputScope(input, "target");
-				if (!scope.ok) return {
-					ok: false,
-					error: scope.error
-				};
-				const scopeValue = scope.value;
-				if (scopeValue === void 0) return {
-					ok: false,
-					error: Errors.invalidInput("target", DESTINATION_SCOPE_MESSAGE)
+			add: (input, options) => {
+				const controls = deps.invocationControls?.(options) ?? options;
+				const actor = actorReferenceToBackend(input.actor);
+				const verifiedScope = {
+					scope_kind: actor?.kind === "org" ? "organization" : "account",
+					...actor?.kind === "org" ? { verified_organization_id: actor.orgId } : {}
 				};
-				const backendActor = actorReferenceToBackend(input.actor);
-				return mapOk(await runIfActive(options?.signal, CAPXUL_OPERATIONS.destinations.add, () => deps.convexCall.mutation(fns.addDestination, {
-					...backendActor === void 0 ? {} : { actor: backendActor },
-					...isSelfTarget(scopeValue) ? { self: true } : { ref: scopeValue },
-					kind: destinationKindToBackend(input.kind),
-					...input.label === void 0 ? {} : { label: input.label },
-					payload: input.payload
-				})), destinationFromBackend);
+				return runPortEffect(Effect.suspend(() => {
+					const scope = normalizeDestinationInputScope(input, "target");
+					if (!scope.ok) return Effect.fail({ publicError: scope.error });
+					const scopeValue = scope.value;
+					if (scopeValue === void 0) return Effect.fail({ publicError: Errors.invalidInput("target", DESTINATION_SCOPE_MESSAGE) });
+					return deps.convexCall.mutation(fns.addDestination, copyInvocationObservation(controls, {
+						...actor === void 0 ? {} : { actor },
+						...isSelfTarget(scopeValue) ? { self: true } : { ref: scopeValue },
+						kind: destinationKindToBackend(input.kind),
+						...input.label === void 0 ? {} : { label: input.label },
+						payload: input.payload
+					})).pipe(Effect.map(destinationFromBackend), Effect.tap(() => Effect.annotateCurrentSpan(verifiedScope)));
+				}), controls, CAPXUL_OPERATIONS.destinations.add, deps.runPromise);
 			},
-			list: async (input, options) => {
-				const scope = normalizeDestinationInputScope(input, "target");
-				if (!scope.ok) return {
-					ok: false,
-					error: scope.error
+			list: (input, options) => {
+				const controls = deps.invocationControls?.(options) ?? options;
+				const actor = actorReferenceToBackend(input.actor);
+				const verifiedScope = {
+					scope_kind: actor?.kind === "org" ? "organization" : "account",
+					...actor?.kind === "org" ? { verified_organization_id: actor.orgId } : {}
 				};
-				const scopeValue = scope.value;
-				return mapOk(await runIfActive(options?.signal, CAPXUL_OPERATIONS.destinations.list, () => deps.convexCall.query(fns.listDestinations, {
-					...input.actor === void 0 ? {} : { actor: actorReferenceToBackend(input.actor) },
-					...scopeValue !== void 0 && isSelfTarget(scopeValue) ? { self: true } : {},
-					...scopeValue !== void 0 && !isSelfTarget(scopeValue) ? { ref: scopeValue } : {}
-				})), (destinations) => destinations.map(destinationFromBackend).filter((destination) => input.kind === void 0 || destination.kind === input.kind));
+				return runPortEffect(Effect.suspend(() => {
+					const scope = normalizeDestinationInputScope(input, "target");
+					if (!scope.ok) return Effect.fail({ publicError: scope.error });
+					const scopeValue = scope.value;
+					return deps.convexCall.query(fns.listDestinations, copyInvocationObservation(controls, {
+						...actor === void 0 ? {} : { actor },
+						...scopeValue !== void 0 && isSelfTarget(scopeValue) ? { self: true } : {},
+						...scopeValue !== void 0 && !isSelfTarget(scopeValue) ? { ref: scopeValue } : {}
+					})).pipe(Effect.map((destinations) => destinations.map(destinationFromBackend).filter((destination) => input.kind === void 0 || destination.kind === input.kind)), Effect.tap(() => Effect.annotateCurrentSpan(verifiedScope)));
+				}), controls, CAPXUL_OPERATIONS.destinations.list, deps.runPromise);
 			},
-			remove: (input, options) => runIfActive(options?.signal, CAPXUL_OPERATIONS.destinations.remove, () => deps.convexCall.mutation(fns.removeDestination, {
-				...input.actor === void 0 ? {} : { actor: actorReferenceToBackend(input.actor) },
-				destinationId: input.destinationId
-			}))
+			remove: (input, options) => {
+				const controls = deps.invocationControls?.(options) ?? options;
+				const actor = actorReferenceToBackend(input.actor);
+				const verifiedScope = {
+					scope_kind: actor?.kind === "org" ? "organization" : "account",
+					...actor?.kind === "org" ? { verified_organization_id: actor.orgId } : {}
+				};
+				return runPortEffect(Effect.suspend(() => deps.convexCall.mutation(fns.removeDestination, copyInvocationObservation(controls, {
+					...actor === void 0 ? {} : { actor },
+					destinationId: input.destinationId
+				})).pipe(Effect.tap(() => Effect.annotateCurrentSpan(verifiedScope)))), controls, CAPXUL_OPERATIONS.destinations.remove, deps.runPromise);
+			}
 		},
 		payments: {
 			pay,
@@ -17479,6 +17711,8 @@ const OBSERVED_CONVEX_QUERIES = /* @__PURE__ */ new Set([
 	"movement/activity:list",
 	"movement/activity:summary",
 	"movement/activity:get",
+	"financialOps/queries:depositInstructions",
+	"financialOps/destinations:list",
 	"financialOps/queries:verifyPaymentDocument",
 	"financialOps/queries:renderStoredDocument",
 	"financialOps/addressBook:list",
@@ -17496,6 +17730,8 @@ const OBSERVED_CONVEX_QUERIES = /* @__PURE__ */ new Set([
 ]);
 const OBSERVED_CONVEX_MUTATIONS = /* @__PURE__ */ new Set([
 	"movement/activity:annotate",
+	"financialOps/destinations:add",
+	"financialOps/destinations:remove",
 	"financialOps/addressBook:add",
 	"financialOps/addressBook:hide",
 	"financialOps/addressBook:unhide",
@@ -44019,7 +44255,7 @@ function readOrgDepositInstructionsProgram(orgId) {
 		const deps = yield* OrgDepsTag;
 		const org = findOrgById(yield* listOrgsProgram(), orgId);
 		if (org === void 0) return yield* Effect.fail(orgNotFound(orgId));
-		return {
+		const instructions = {
 			accountKind: "orgTreasury",
 			chainId: Number(deps.chainId ?? 84532),
 			network: "base-sepolia",
@@ -44027,6 +44263,8 @@ function readOrgDepositInstructionsProgram(orgId) {
 			address: String(org.safeAddress).toLowerCase(),
 			label: "Capxul org treasury"
 		};
+		yield* emitDepositInitiated(deps.telemetry, instructions, deps.invocationSource, String(org.id));
+		return instructions;
 	});
 }
 function listRolesProgram(orgId) {
@@ -44261,12 +44499,12 @@ function makeOrgMethods(deps) {
 						});
 						return toCapxulResult(readOrgProfileProgram(orgId), layer);
 					},
-					depositInstructions(_options) {
-						if (_options?.signal?.aborted) return Promise.resolve({
-							ok: false,
-							error: Errors.cancelled({ operation: CAPXUL_OPERATIONS.org.profile.depositInstructions })
-						});
-						return toCapxulResult(readOrgDepositInstructionsProgram(orgId), layer);
+					depositInstructions(options) {
+						const controls = deps.invocationControls?.(options) ?? options;
+						return runCapxulEffect(readOrgDepositInstructionsProgram(orgId).pipe(Effect.provide(orgDepsLayer({
+							...orgDeps,
+							...controls === void 0 ? {} : { invocationSource: controls }
+						}))), controls, CAPXUL_OPERATIONS.org.profile.depositInstructions, deps.runPromise);
 					}
 				},
 				treasury(options) {
@@ -46415,7 +46653,7 @@ function stdioIdentity(env = process.env, options = {}) {
 }
 //#endregion
 //#region package.json
-var version = "4.0.1";
+var version = "4.1.1";
 //#endregion
 //#region src/deps.ts
 const NO_IDENTITY = async () => void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/mcp",
-  "version": "4.0.1",
+  "version": "4.1.1",
   "private": false,
   "description": "Capxul MCP server for auth, Account readiness, identity, Organizations, relationships, requests, destinations, and testnet funding over Streamable HTTP.",
   "keywords": [
@@ -51,7 +51,7 @@
     "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
     "vite-plus": "0.3.0",
     "@capxul/config": "0.3.0",
-    "@capxul/sdk": "4.0.1",
+    "@capxul/sdk": "4.1.1",
     "@capxul/typescript-config": "0.0.0"
   },
   "scripts": {