@capxul/sdk 4.0.1 → 4.1.1

package/dist/{create-capxul-client-5Bk0PS0R.mjs → create-capxul-client-QHfE4dEP.mjs}

@@ -440,12 +440,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",
@@ -1304,7 +1306,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,
@@ -1542,6 +1557,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 redactTelemetryEvent(event, options = {}) {
 	const props = redactTelemetryProps(event.name, event.props, options);
 	return props === void 0 ? { name: event.name } : {
@@ -4181,6 +4338,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);
@@ -4209,8 +4383,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 },
@@ -5043,7 +5219,7 @@ const moneyExecutionContract = {
 };
 //#endregion
 //#region package.json
-var version = "4.0.1";
+var version = "4.1.1";
 //#endregion
 //#region src/telemetry/exception-projection.ts
 /** Fixed fallback for failures that have no safe message. */
@@ -5754,11 +5930,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, {
@@ -6374,7 +6589,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");
@@ -6382,43 +6600,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,
@@ -9026,7 +9258,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",
@@ -9034,6 +9266,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) {
@@ -9268,12 +9502,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) {

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { B as EVM_ADDRESS_RE, Ct as RevertSummary, E as Address, G as OrgId, I as CountryCode, J as PayrollGroupId, K as PartyId, M as AuthUserId, P as BudgetId, St as FailureMode, T as AccountId, U as Handle, W as Money, Y as PayrollRunId, _t as isCapxulError, a as SignerStatusStore, bt as ChainUpstream, c as AccountProviderSource, ct as toHandle, d as eip1193AccountProvider, dt as CAPXUL_ERROR_CODES, et as RoleKey, f as localPrivateKeyAccountProvider, ft as CapxulError, g as SmartAccount, h as Session, ht as Errors, i as SignerStatus, j as AuthSession, l as AccountRequirement, lt as toPartyId, m as Profile, mt as CapxulErrorDetails, n as CapxulSigner, o as injectedWalletSigner, ot as toAddress, p as CapxulResult, pt as CapxulErrorCode, r as Eip1193RequestProvider, rt as TesterKind, s as AccountProvider, st as toCountryCode, t as CapxulDigestSigner, u as Eip1193Provider, ut as CAPXUL_PAYMENTS_V2_ADDRESS, vt as CHAIN_UPSTREAMS, w as Account, xt as FAILURE_MODES, yt as ChainCause } from "./signer-C0hZ6Kiy.mjs";
-import { $ as OrganizationPaymentsMethods, $n as TelemetryPort, $t as DestinationListInput, A as OrgView, An as TargetsMethods, At as AddressBookMethods, B as PayrollGroupInput, Bn as OrgSetupStep, Bt as ActivityListParams, C as DetectPendingOrgInvitationsResult, Cn as PaymentType, Ct as ActorRelationshipMethods, D as OrgMethods, Dn as Ref, Dt as AddressBookAddInput, E as MemberView, En as RecipientResolution, Et as ActorRequestsMethods, F as RoleSpendCap, Fn as CompleteProfileInput, Ft as ActivityAnnotationInput, G as PayrollRun, Gn as InboxStatus, Gt as ActivitySummary, H as PayrollGroupsMethods, Hn as CurrentHoldings, Ht as ActivityPage, I as RoleView, In as IdentityMethods, It as ActivityDetail, J as PayrollRuns, Jn as PaymentStatus$1, Jt as ActorReference, K as PayrollRunItemInput, Kn as PAYMENT_DIRECTIONS, Kt as ActivitySummaryParams, L as AuthorizeRunInput, Ln as SmartAccountMethods, Lt as ActivityFilter, M as OrganizationAuditLogItem, Mn as AccountLifecycle, Mt as InboxItem, N as ResendInviteTokenInput, Nn as AccountSetupStep, Nt as InboxMethods, O as OrgScopedMethods, On as ResolvedTarget, Ot as AddressBookEntry, P as RoleDefinition, Pn as isSettingUpLifecycle, Pt as ActivityAnnotation, Q as OrganizationPaymentItemInput, Qt as DestinationKind, R as PayrollEngagementTerms, Rn as AuthMethods, Rt as ActivityItem, S as CreateOrgInput, Sn as PaymentTiming, St as ActorProfileMethods, T as MemberStatus, Tn as PaymentsPayInput, Tt as ActorRequestIssueInput, U as PayrollMethods, Un as Permission, Ut as ActivityRange, V as PayrollGroupMember, Vn as ActorRef, Vt as ActivityMethods, W as PayrollOptions, Wn as SubmittedPermissionExecution, Wt as ActivityReference, X as OrganizationPaymentBatchInput, Xt as Destination, Y as PayrollTermsUnit, Yn as RequestStatus, Yt as DepositInstructions, Z as OrganizationPaymentInput, Zt as DestinationAddInput, _ as SystemMethods, _n as PaymentDocumentRender, _t as PersonOnboarding, a as SdkFailureObservation, an as MeMethods, ar as StateLabel, at as PermissionReplaceInput, b as CurrentUserContext, bn as PaymentMoney, bt as AccountMethods, c as PostHogObservabilityOptions, cn as OfframpMethods, cr as isRestoring, ct as Budget, d as CreateCapxulClientInput, dn as OfframpStatus, dt as OrgMeOptions, en as DestinationPayload, er as Destination$1, et as PermissionAssignInput, f as IdentityProfileDetails, fn as Payment, ft as AccountsMethods, g as Holding, gn as PaymentDocumentRef, gt as OrganizationOnboardingInput, h as HoldingsMethods, hn as PaymentDocumentKind, ht as OrganizationOnboarding, i as ObservationDelivery, in as FinancialOpsMethods, ir as Readiness, it as PermissionOptions, j as OrganizationAccount, jn as fingerprintPaymentIntent, jt as InboxApproveInput, k as OrgTemplate, kn as TargetReference, kt as AddressBookLabelInput, l as postHogObservability, ln as OfframpQuote, lr as IdentityTransition, lt as OrgMe, m as IdentityRuntimeSendResult, mn as PaymentDirection, mt as OnboardingMethods, n as ObservationAdapter, nn as DestinationRemoveInput, nr as IdentityState, nt as PermissionCreateInput, o as HostObservability, on as MeProfile, or as destination, ot as PermissionRevokeInput, p as IdentityRuntime, pn as PaymentActivityEvidence, pt as CompletedPersonProfile, q as PayrollRunStatus, qn as PAYMENT_STATUSES, qt as ActivitySummaryTotal, r as ObservationContext, rn as DestinationsMethods, rr as OrgLane, rt as PermissionMethods, s as PostHogObservabilityClient, sn as MovementActivityEvidence, sr as isClaimed, st as PermissionReadResult, t as CAPXUL_SDK_EXPECTED_OUTCOME_EVENT, tn as DestinationRail, tr as IdentityEvent, tt as PermissionChangeInput, u as CapxulClient, un as OfframpQuoteInput, ur as InvocationControls, ut as OrgMeMethod, v as SystemHealth, vn as PaymentDocumentVerification, vt as PersonOnboardingInput, w as InviteMemberInput, wn as PaymentsMethods, wt as ActorRequest, x as CurrentUserMethods, xn as PaymentStatus, xt as ActorProfile, y as MediaMethods, yn as PaymentDocumentsMethods, yt as ReadyAccountLifecycle, z as PayrollGroup, zn as OrgLifecycle, zt as ActivityKind } from "./observation-DtzTdv20.mjs";
+import { $ as OrganizationPaymentsMethods, $n as TelemetryPort, $t as DestinationListInput, A as OrgView, An as TargetsMethods, At as AddressBookMethods, B as PayrollGroupInput, Bn as OrgSetupStep, Bt as ActivityListParams, C as DetectPendingOrgInvitationsResult, Cn as PaymentType, Ct as ActorRelationshipMethods, D as OrgMethods, Dn as Ref, Dt as AddressBookAddInput, E as MemberView, En as RecipientResolution, Et as ActorRequestsMethods, F as RoleSpendCap, Fn as CompleteProfileInput, Ft as ActivityAnnotationInput, G as PayrollRun, Gn as InboxStatus, Gt as ActivitySummary, H as PayrollGroupsMethods, Hn as CurrentHoldings, Ht as ActivityPage, I as RoleView, In as IdentityMethods, It as ActivityDetail, J as PayrollRuns, Jn as PaymentStatus$1, Jt as ActorReference, K as PayrollRunItemInput, Kn as PAYMENT_DIRECTIONS, Kt as ActivitySummaryParams, L as AuthorizeRunInput, Ln as SmartAccountMethods, Lt as ActivityFilter, M as OrganizationAuditLogItem, Mn as AccountLifecycle, Mt as InboxItem, N as ResendInviteTokenInput, Nn as AccountSetupStep, Nt as InboxMethods, O as OrgScopedMethods, On as ResolvedTarget, Ot as AddressBookEntry, P as RoleDefinition, Pn as isSettingUpLifecycle, Pt as ActivityAnnotation, Q as OrganizationPaymentItemInput, Qt as DestinationKind, R as PayrollEngagementTerms, Rn as AuthMethods, Rt as ActivityItem, S as CreateOrgInput, Sn as PaymentTiming, St as ActorProfileMethods, T as MemberStatus, Tn as PaymentsPayInput, Tt as ActorRequestIssueInput, U as PayrollMethods, Un as Permission, Ut as ActivityRange, V as PayrollGroupMember, Vn as ActorRef, Vt as ActivityMethods, W as PayrollOptions, Wn as SubmittedPermissionExecution, Wt as ActivityReference, X as OrganizationPaymentBatchInput, Xt as Destination, Y as PayrollTermsUnit, Yn as RequestStatus, Yt as DepositInstructions, Z as OrganizationPaymentInput, Zt as DestinationAddInput, _ as SystemMethods, _n as PaymentDocumentRender, _t as PersonOnboarding, a as SdkFailureObservation, an as MeMethods, ar as StateLabel, at as PermissionReplaceInput, b as CurrentUserContext, bn as PaymentMoney, bt as AccountMethods, c as PostHogObservabilityOptions, cn as OfframpMethods, cr as isRestoring, ct as Budget, d as CreateCapxulClientInput, dn as OfframpStatus, dt as OrgMeOptions, en as DestinationPayload, er as Destination$1, et as PermissionAssignInput, f as IdentityProfileDetails, fn as Payment, ft as AccountsMethods, g as Holding, gn as PaymentDocumentRef, gt as OrganizationOnboardingInput, h as HoldingsMethods, hn as PaymentDocumentKind, ht as OrganizationOnboarding, i as ObservationDelivery, in as FinancialOpsMethods, ir as Readiness, it as PermissionOptions, j as OrganizationAccount, jn as fingerprintPaymentIntent, jt as InboxApproveInput, k as OrgTemplate, kn as TargetReference, kt as AddressBookLabelInput, l as postHogObservability, ln as OfframpQuote, lr as IdentityTransition, lt as OrgMe, m as IdentityRuntimeSendResult, mn as PaymentDirection, mt as OnboardingMethods, n as ObservationAdapter, nn as DestinationRemoveInput, nr as IdentityState, nt as PermissionCreateInput, o as HostObservability, on as MeProfile, or as destination, ot as PermissionRevokeInput, p as IdentityRuntime, pn as PaymentActivityEvidence, pt as CompletedPersonProfile, q as PayrollRunStatus, qn as PAYMENT_STATUSES, qt as ActivitySummaryTotal, r as ObservationContext, rn as DestinationsMethods, rr as OrgLane, rt as PermissionMethods, s as PostHogObservabilityClient, sn as MovementActivityEvidence, sr as isClaimed, st as PermissionReadResult, t as CAPXUL_SDK_EXPECTED_OUTCOME_EVENT, tn as DestinationRail, tr as IdentityEvent, tt as PermissionChangeInput, u as CapxulClient, un as OfframpQuoteInput, ur as InvocationControls, ut as OrgMeMethod, v as SystemHealth, vn as PaymentDocumentVerification, vt as PersonOnboardingInput, w as InviteMemberInput, wn as PaymentsMethods, wt as ActorRequest, x as CurrentUserMethods, xn as PaymentStatus, xt as ActorProfile, y as MediaMethods, yn as PaymentDocumentsMethods, yt as ReadyAccountLifecycle, z as PayrollGroup, zn as OrgLifecycle, zt as ActivityKind } from "./observation-Bcmb-GIA.mjs";
 import "./OAuthBearerAuthClient-D-DLYlKj.mjs";
 import { Context, Effect, Layer } from "effect";
 import { Hex } from "viem";
@@ -47,12 +47,14 @@ declare const CAPXUL_OPERATIONS: {
   };
   readonly activity: {
     readonly annotate: "activity.annotate";
+    readonly emitAnnotationSaved: "activity.emitAnnotationSaved";
     readonly get: "activity.get";
     readonly list: "activity.list";
     readonly summary: "activity.summary";
   };
   readonly addressBook: {
     readonly add: "addressBook.add";
+    readonly emitRelationshipChanged: "addressBook.emitRelationshipChanged";
     readonly get: "addressBook.get";
     readonly hide: "addressBook.hide";
     readonly label: "addressBook.label";

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as stampTelemetryEnvelope, A as safeExceptionLabel, B as resolveFailureMode, C as observeFailedResult, D as normalizeExceptionErrorKind, E as SDK_VERSION$1, F as causeChain, G as sanitizeObservationContext, H as readInvocationObservation, I as injectedWalletSigner, J as CAPXUL_FUNCTIONS, K as PAYMENT_DIRECTIONS, L as isSignerNotReadySignal, M as fromWei, N as isSettingUpLifecycle, O as normalizeExceptionOperation, P as formatTraceparent, Q as redactTelemetryProps, R as openfortSignerNotReadyCode, S as observationContextProps, T as EXCEPTION_MESSAGE, U as OBSERVATION_CONTEXT_HEADER, V as copyInvocationObservation, W as encodeObservationContextHeader, X as EngineeringTelemetryBootstrapPolicy, Y as BootstrapEnvelope, _ as fingerprintPaymentIntent, a as AccountReadPortTag, at as isRestoring, b as failureDetail, c as retryIdempotentRead, d as IdentityPortTag, et as CAPXUL_OPERATIONS, f as identityErrorFromCapxul, g as bootstrapErrorFromCapxul, h as BootstrapPortTag, i as smartAccountErrorFromCapxul, it as isClaimed, j as version, k as projectSdkException, l as PRODUCT_INVOCATION, m as convexCallErrorFromCapxul, n as detectAuthCacheAdapter, nt as normalizeCapxulOperation, o as accountReadErrorFromCapxul, p as ConvexCallPortTag, q as PAYMENT_STATUSES, r as SmartAccountPortTag, rt as destination, s as TelemetryPortTag, t as assembleCapxulClient, tt as isCapxulOperation, u as wireChainId, v as toWei, w as postHogFailureObservation, x as failureEvidenceProps, y as CAPXUL_SDK_EXPECTED_OUTCOME_EVENT, z as signerFailure } from "./create-capxul-client-5Bk0PS0R.mjs";
+import { $ as stampTelemetryEnvelope, A as safeExceptionLabel, B as resolveFailureMode, C as observeFailedResult, D as normalizeExceptionErrorKind, E as SDK_VERSION$1, F as causeChain, G as sanitizeObservationContext, H as readInvocationObservation, I as injectedWalletSigner, J as CAPXUL_FUNCTIONS, K as PAYMENT_DIRECTIONS, L as isSignerNotReadySignal, M as fromWei, N as isSettingUpLifecycle, O as normalizeExceptionOperation, P as formatTraceparent, Q as redactTelemetryProps, R as openfortSignerNotReadyCode, S as observationContextProps, T as EXCEPTION_MESSAGE, U as OBSERVATION_CONTEXT_HEADER, V as copyInvocationObservation, W as encodeObservationContextHeader, X as EngineeringTelemetryBootstrapPolicy, Y as BootstrapEnvelope, _ as fingerprintPaymentIntent, a as AccountReadPortTag, at as isRestoring, b as failureDetail, c as retryIdempotentRead, d as IdentityPortTag, et as CAPXUL_OPERATIONS, f as identityErrorFromCapxul, g as bootstrapErrorFromCapxul, h as BootstrapPortTag, i as smartAccountErrorFromCapxul, it as isClaimed, j as version, k as projectSdkException, l as PRODUCT_INVOCATION, m as convexCallErrorFromCapxul, n as detectAuthCacheAdapter, nt as normalizeCapxulOperation, o as accountReadErrorFromCapxul, p as ConvexCallPortTag, q as PAYMENT_STATUSES, r as SmartAccountPortTag, rt as destination, s as TelemetryPortTag, t as assembleCapxulClient, tt as isCapxulOperation, u as wireChainId, v as toWei, w as postHogFailureObservation, x as failureEvidenceProps, y as CAPXUL_SDK_EXPECTED_OUTCOME_EVENT, z as signerFailure } from "./create-capxul-client-QHfE4dEP.mjs";
 import { $ as CapxulError, A as toAuthUserId, B as toJwtToken, D as toAddress, E as toAccountId, F as toDurationMs, H as toOrgId, I as toEmail, J as toSessionToken, K as toPublishableKey, L as toEpochMs, M as toChainId, N as toCountryCode, O as toAllowedOrigin, P as toCurrencyCode, Q as CAPXUL_ERROR_CODES, R as toEpochSeconds, T as currencySymbolFor, U as toPartyId, V as toKycTier, X as HANDLE_RE, Y as toTesterKind, Z as decodeConvexError, d as AuthClientError, f as AuthClientPortTag, g as BASE_SEPOLIA_CHAIN_ID, h as normalizeBindingEmail, it as FAILURE_MODES, l as ClockPortTag, m as CAPXUL_PAYMENTS_V2_ADDRESS, nt as isCapxulError, q as toRoleKey, rt as CHAIN_UPSTREAMS, s as AuthCachePortTag, tt as Errors, u as authClientPortFromPromiseAdapter, x as EVM_ADDRESS_RE, z as toHandle } from "./clock-C2AUlq1V.mjs";
 import { n as SystemClockLayer } from "./OAuthBearerAuthClient-BHvDR8_0.mjs";
 import { Cause, Context, Data, Duration, Effect, Exit, Layer, Result, Schedule, SchemaIssue, SchemaParser, Scope, Tracer } from "effect";
@@ -1615,6 +1615,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",
@@ -1632,6 +1634,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",

package/dist/{observation-DtzTdv20.d.mts → observation-Bcmb-GIA.d.mts}

@@ -279,7 +279,7 @@ interface TelemetryPort {
 }
 //#endregion
 //#region ../observability/src/index.d.ts
-declare const TELEMETRY_EVENT_NAMES: readonly ["auth_otp_requested", "auth_otp_delivered", "auth_otp_expired", "auth_verified", "auth_failed", "auth_signed_out", "onboarding_intent_selected", "onboarding_profile_submitted", "onboarding_organization_submitted", "onboarding_dashboard_reached", "provisioning_safe_created", "provisioning_safe_confirmed", "bootstrap_resolved", "bootstrap_failed", "member_activation_started", "member_activation_ready", "member_activation_failed", "organization_creation_started", "organization_creation_ready", "organization_creation_failed", "chain_upstream_fallback", "bundler_error", "receipt_pending", "operation_retried", "account_balance_read", "account_balance_failed", "faucet_requested", "faucet_confirmed", "faucet_failed", "org_create_started", "org_safe_created", "org_safe_confirmed", "org_roles_seeded", "org_created", "org_create_failed", "org_invite_sent", "org_invite_accepted", "org_invite_expired", "payment_initiated", "payment_settled", "payment_failed", "payment_verification_retry", "payment_lifecycle_transition", "quick_pay_external_address_acknowledged", "deposit_initiated", "deposit_settled", "permission_mirror_verification", "movement_scan_window", "movement_scan_checkpoint", "movement_scan_incident"];
+declare const TELEMETRY_EVENT_NAMES: readonly ["auth_otp_requested", "auth_otp_delivered", "auth_otp_expired", "auth_verified", "auth_failed", "auth_signed_out", "onboarding_intent_selected", "onboarding_profile_submitted", "onboarding_organization_submitted", "onboarding_dashboard_reached", "provisioning_safe_created", "provisioning_safe_confirmed", "bootstrap_resolved", "bootstrap_failed", "member_activation_started", "member_activation_ready", "member_activation_failed", "organization_creation_started", "organization_creation_ready", "organization_creation_failed", "chain_upstream_fallback", "bundler_error", "receipt_pending", "operation_retried", "account_balance_read", "account_balance_failed", "faucet_requested", "faucet_confirmed", "faucet_failed", "org_create_started", "org_safe_created", "org_safe_confirmed", "org_roles_seeded", "org_created", "org_create_failed", "org_invite_sent", "org_invite_accepted", "org_invite_expired", "payment_initiated", "payment_settled", "payment_failed", "payment_verification_retry", "payment_lifecycle_transition", "quick_pay_external_address_acknowledged", "deposit_initiated", "deposit_settled", "permission_mirror_verification", "movement_scan_window", "movement_scan_checkpoint", "movement_scan_incident", "activity_annotation_saved", "ui_activity_action_completed", "contact_relationship_changed", "ui_contact_action_completed"];
 type TelemetryEventName = (typeof TELEMETRY_EVENT_NAMES)[number];
 type TelemetryProps = Record<string, unknown>;
 type TelemetryEvent = {

package/dist/testing/index.d.mts

@@ -1,4 +1,4 @@
-import { Qn as TelemetryIdentifyInput, Xn as TelemetryEvent, Zn as TelemetryGroupInput, lr as IdentityTransition, n as ObservationAdapter, u as CapxulClient } from "../observation-DtzTdv20.mjs";
+import { Qn as TelemetryIdentifyInput, Xn as TelemetryEvent, Zn as TelemetryGroupInput, lr as IdentityTransition, n as ObservationAdapter, u as CapxulClient } from "../observation-Bcmb-GIA.mjs";
 import { Effect, Layer } from "effect";
 //#region src/testing/telemetry/RecordingTelemetryAdapter.d.ts
 type RecordingTelemetryOperation = {

package/dist/testing/index.mjs

@@ -1,4 +1,4 @@
-import { M as fromWei, Z as redactTelemetryEvent, f as identityErrorFromCapxul, g as bootstrapErrorFromCapxul, i as smartAccountErrorFromCapxul, m as convexCallErrorFromCapxul, o as accountReadErrorFromCapxul, t as assembleCapxulClient, u as wireChainId, v as toWei } from "../create-capxul-client-5Bk0PS0R.mjs";
+import { M as fromWei, Z as redactTelemetryEvent, f as identityErrorFromCapxul, g as bootstrapErrorFromCapxul, i as smartAccountErrorFromCapxul, m as convexCallErrorFromCapxul, o as accountReadErrorFromCapxul, t as assembleCapxulClient, u as wireChainId, v as toWei } from "../create-capxul-client-QHfE4dEP.mjs";
 import { $ as CapxulError, A as toAuthUserId, B as toJwtToken, D as toAddress, E as toAccountId, F as toDurationMs, I as toEmail, J as toSessionToken, K as toPublishableKey, L as toEpochMs, M as toChainId, N as toCountryCode, O as toAllowedOrigin, R as toEpochSeconds, V as toKycTier, _ as deriveCapxulSafeAddress, k as toAppId, n as InMemoryAuthCacheAdapter, t as readClockNow, tt as Errors, u as authClientPortFromPromiseAdapter, v as validateHandle, z as toHandle } from "../clock-C2AUlq1V.mjs";
 import { Effect, Result, Semaphore } from "effect";
 import { keccak256 } from "viem";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk",
-  "version": "4.0.1",
+  "version": "4.1.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -49,10 +49,10 @@
     "vitest": "4.1.11",
     "@capxul/config": "0.3.0",
     "@capxul/errors": "0.3.0",
-    "@capxul/typescript-config": "0.0.0",
-    "@capxul/wire": "0.7.0",
     "@capxul/types": "0.3.0",
-    "@capxul/observability": "4.0.1"
+    "@capxul/observability": "4.1.1",
+    "@capxul/wire": "0.7.0",
+    "@capxul/typescript-config": "0.0.0"
   },
   "_permissionlessPinReason": "permissionless.toSafeSmartAccount is pinned to 0.3.4 for live Safe deployment E2E. Counterfactual address fixtures captured 2026-05-17 in packages/backend/convex/_shared/__tests__/counterfactual.test.ts and packages/config/tests/safe.test.ts must be re-verified before upgrading.",
   "scripts": {