@wildo-ai/saas-models 1.1.5 → 1.1.6

package/dist/esm/companion/provider-discovery.shared.schemas.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { AppFrontendType } from '../config/app-frontend-type.shared.schemas';
 import { EngineCapability } from '../external-providers/engine-capabilities.shared.schemas';
+import { ProviderTier } from '../external-providers/provider-metadata.shared.schemas';
 /**
  * Companion-safe provider implementation declaration.
  *
@@ -99,7 +100,7 @@ export declare const ProviderCompanionContributionSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>;
         packageName: z.ZodString;
-        tier: z.ZodEnum<typeof import("..").ProviderTier>;
+        tier: z.ZodEnum<typeof ProviderTier>;
         vendor: z.ZodString;
     }, z.core.$strip>>;
     /**
@@ -141,7 +142,7 @@ export declare const ProviderCompanionContributionSchema: z.ZodObject<{
         metadata: z.ZodObject<{
             ref: z.ZodString;
             packageName: z.ZodString;
-            tier: z.ZodEnum<typeof import("..").ProviderTier>;
+            tier: z.ZodEnum<typeof ProviderTier>;
             vendor: z.ZodString;
             origin: z.ZodObject<{
                 kind: z.ZodEnum<typeof import("..").ProviderOriginKind>;
@@ -165,6 +166,8 @@ export declare const ProviderCompanionContributionSchema: z.ZodObject<{
             imgOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
             styleOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
             fontOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            workerOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            mediaOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
             derivedOrigins: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 publicConfigKey: z.ZodString;
                 bucket: z.ZodEnum<typeof import("..").ProviderFrontendCspOriginBucket>;
@@ -183,6 +186,13 @@ export declare const ProviderCompanionContributionSchema: z.ZodObject<{
         }, z.core.$strict>>>;
         components: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             selectionDelivery: z.ZodOptional<z.ZodEnum<typeof import("..").ProviderFrontendSelectionDelivery>>;
+            placeIdRetention: z.ZodOptional<z.ZodEnum<typeof import("..").ProviderAddressLookupPlaceIdRetention>>;
+            addressLookup: z.ZodOptional<z.ZodObject<{
+                suggestOperationId: z.ZodString;
+                retrieveOperationId: z.ZodString;
+                sessionTokenInput: z.ZodOptional<z.ZodString>;
+                attributionMark: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
         }, z.core.$strict>>>;
         publicConfigKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
         fileStorage: z.ZodOptional<z.ZodEnum<{
@@ -192,15 +202,146 @@ export declare const ProviderCompanionContributionSchema: z.ZodObject<{
             readonly GOOGLE_DRIVE: "google_drive";
             readonly DROPBOX: "dropbox";
         }>>;
+        complianceProfile: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            determination: z.ZodOptional<z.ZodLiteral<import("..").ProviderComplianceDetermination.ESTABLISHED>>;
+            deploymentModels: z.ZodArray<z.ZodEnum<typeof import("..").ProviderDeploymentModel>>;
+            processingRegions: z.ZodArray<z.ZodString>;
+            vendorLegalEntityName: z.ZodOptional<z.ZodString>;
+            subprocessorListUrl: z.ZodOptional<z.ZodURL>;
+            dataProcessingAgreementUrl: z.ZodOptional<z.ZodURL>;
+            evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                facts: z.ZodArray<z.ZodEnum<typeof import("..").ProviderComplianceFact>>;
+                source: z.ZodURL;
+                verifiedAt: z.ZodISODate;
+            }, z.core.$strict>>>;
+            subjectErasure: z.ZodOptional<z.ZodObject<{
+                stance: z.ZodEnum<{
+                    readonly NO_SUBJECT_DATA: import("..").HttpApiErasureStance.NO_SUBJECT_DATA;
+                    readonly EXTERNAL_ERASURE_OPERATION: import("..").HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION;
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            determination: z.ZodLiteral<import("..").ProviderComplianceDetermination.UNDETERMINED>;
+            reason: z.ZodString;
+        }, z.core.$strict>]>>;
+        consentPurposes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$loose>>;
     /**
      * Optional app module owner when the provider implementation belongs to one
      * concrete module instead of the whole package/runtime.
      */
     sourceModuleId: z.ZodOptional<z.ZodString>;
+    /**
+     * The hosts the provider's OAuth2 TOKEN endpoint may resolve to (#1725) — derived by the producer with
+     * `describeProviderOAuth2TokenEndpointHosts`, absent when the provider runs no OAuth2 connected account.
+     *
+     * Carried so `wildo config sync` can refuse a declared shared connection whose member names a different
+     * authorization server than its base, without loading either module. Values-free: a login host is not a
+     * secret. Optional on the wire because a contribution emitted before #1725 carries none; the registry then
+     * makes the same comparison on the loaded modules at boot.
+     */
+    oauth2TokenEndpointHosts: z.ZodOptional<z.ZodObject<{
+        exact: z.ZodArray<z.ZodString>;
+        suffixes: z.ZodArray<z.ZodString>;
+        undeterminable: z.ZodBoolean;
+    }, z.core.$strict>>;
+    /**
+     * The secrets-contract SLUGS holding the provider's connected-account OAuth2 client registration — its client id
+     * and client secret (#1725). Absent when the provider runs no OAuth2 connected account.
+     *
+     * Carried so `wildo secrets` can tell an operator which registration a declared shared connection actually needs:
+     * the BASE's slots are then required, and a MEMBER's own slots are inert — reported, never required — because the
+     * base's client connects and refreshes the one grant.
+     */
+    oauth2ClientSlotSlugs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    /**
+     * What the provider's BACKEND module declares about who runs it and where it processes (#1708) — ESTABLISHED
+     * facts, or UNDETERMINED. A frontend facet's profile rides `frontendEntry.complianceProfile` instead (#1743).
+     *
+     * Carried so the compliance readers (the evidence collector, the companion's drafting brief) learn every
+     * declared provider's profile from discovery, WITHOUT loading a provider module — the same reason
+     * `oauth2TokenEndpointHosts` is here. Values-free: a vendor's region list is not a secret. Optional on the wire
+     * because a contribution emitted before #1708 carries none, which a reader reports as "no profile".
+     */
+    complianceProfile: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        determination: z.ZodOptional<z.ZodLiteral<import("..").ProviderComplianceDetermination.ESTABLISHED>>;
+        deploymentModels: z.ZodArray<z.ZodEnum<typeof import("..").ProviderDeploymentModel>>;
+        processingRegions: z.ZodArray<z.ZodString>;
+        vendorLegalEntityName: z.ZodOptional<z.ZodString>;
+        subprocessorListUrl: z.ZodOptional<z.ZodURL>;
+        dataProcessingAgreementUrl: z.ZodOptional<z.ZodURL>;
+        evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            facts: z.ZodArray<z.ZodEnum<typeof import("..").ProviderComplianceFact>>;
+            source: z.ZodURL;
+            verifiedAt: z.ZodISODate;
+        }, z.core.$strict>>>;
+        subjectErasure: z.ZodOptional<z.ZodObject<{
+            stance: z.ZodEnum<{
+                readonly NO_SUBJECT_DATA: import("..").HttpApiErasureStance.NO_SUBJECT_DATA;
+                readonly EXTERNAL_ERASURE_OPERATION: import("..").HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION;
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        determination: z.ZodLiteral<import("..").ProviderComplianceDetermination.UNDETERMINED>;
+        reason: z.ZodString;
+    }, z.core.$strict>]>>;
 }, z.core.$loose>;
 export type ProviderCompanionContribution = z.infer<typeof ProviderCompanionContributionSchema>;
+/**
+ * A package's declaration that it ADDS OPERATIONS to a provider it does not own (#1672).
+ *
+ * ## Why this is its own record and not a `ProviderCompanionContribution`
+ *
+ * A contribution says "this package OWNS provider X": identity, secrets contract, protocols, the runtimes
+ * it reaches. Discovery keeps one owner per ref and compares every contribution's secrets-contract shape
+ * against the others. An augmentation owns none of that — the base keeps identity, tier, secrets contract,
+ * OAuth2 block and connection — so recording it as a second contribution of the same ref would make the
+ * shape comparison treat it as a second owner, and the import map would pick one of the two by sort order.
+ * A separate record is what lets the base stay the base.
+ *
+ * ## What it carries, and why each field is STATIC
+ *
+ * `operationIds` and `requiredScopes` are stated here rather than read from the catalogue because a
+ * catalogue is a LAZY loader that tooling must never call (`ProviderRestOperationCatalogueLoader`). So
+ * `wildo config sync` can refuse an operation-id collision and record which scopes an augmentation may ask
+ * for without evaluating any vendor code; the runtime then checks that what the loader delivers is exactly
+ * what was declared here, and refuses the augmentation otherwise.
+ *
+ * INERT until an application opts it in under `providers.augmentations.<augments>` — installing a package
+ * never adds an operation to a provider on its own.
+ *
+ * Loose for the reason `ProviderCompanionContributionSchema` is: a newer producer's additive field must ride
+ * through an older consumer.
+ */
+export declare const ProviderAugmentationContributionSchema: z.ZodObject<{
+    /** The ref of the provider this package adds operations to — owned by the engine or another package. */
+    augments: z.ZodString;
+    /** The augmentation package's own npm name, as its manifest states it. */
+    packageName: z.ZodString;
+    /** Always `CATALOGUE`: an augmentation binds no engine slot and adds only operations. */
+    tier: z.ZodLiteral<ProviderTier.CATALOGUE>;
+    origin: z.ZodObject<{
+        kind: z.ZodEnum<typeof import("..").ProviderOriginKind>;
+        catalogue: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<typeof import("..").ProviderCatalogueSource>;
+            sourceRef: z.ZodString;
+            sourceVersion: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    /** The specifier a host imports to read the augmentation (`<package>/backend` by convention). */
+    runtimeImportPath: z.ZodString;
+    /** Every operation id the augmentation contributes — sorted, unique, non-empty. */
+    operationIds: z.ZodArray<z.ZodString>;
+    /** Every vendor scope any of those operations declares in `requiredScopes` — sorted, unique. */
+    requiredScopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+export type ProviderAugmentationContribution = z.infer<typeof ProviderAugmentationContributionSchema>;
 export interface RuntimeOwnerCompanionExports {
     providerContributions?: ProviderCompanionContribution[];
+    /**
+     * Operation augmentations of providers this package does not own (#1672). Separate from
+     * `providerContributions` on purpose — see {@link ProviderAugmentationContributionSchema}.
+     */
+    providerAugmentations?: ProviderAugmentationContribution[];
 }
 //# sourceMappingURL=provider-discovery.shared.schemas.d.ts.map

package/dist/esm/companion/provider-discovery.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-discovery.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAI5F;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0CAA0C;;;kBAGrD,CAAC;AACH,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;AAE9G,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;4BAgB/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG;;;;;;GAMG;AACH,eAAO,MAAM,sCAAsC;;;;;kBAKjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC;;;;;mBA+B5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC;;IAE9C;;;;;;OAMG;;;;;;;;;;;;;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;IAOH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;iBAEH,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG,MAAM,WAAW,4BAA4B;IAC3C,qBAAqB,CAAC,EAAE,6BAA6B,EAAE,CAAC;CACzD"}
+{"version":3,"file":"provider-discovery.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAE5F,OAAO,EAAgD,YAAY,EAAE,MAAM,wDAAwD,CAAC;AAGpI;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0CAA0C;;;kBAGrD,CAAC;AACH,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;AAE9G,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;4BAgB/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG;;;;;;GAMG;AACH,eAAO,MAAM,sCAAsC;;;;;kBAKjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC;;;;;mBA+B5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC;;IAE9C;;;;;;OAMG;;;;;;;;;;;;;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;IAOH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;IAEH;;;;;;;;OAQG;;;;;;IAMH;;;;;;;OAOG;;IAEH;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;;;;;iBAEH,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sCAAsC;IACjD,wGAAwG;;IAExG,0EAA0E;;IAE1E,yFAAyF;;;;;;;;;;IAGzF,iGAAiG;;IAEjG,mFAAmF;;IAEnF,gGAAgG;;iBAUhG,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG,MAAM,WAAW,4BAA4B;IAC3C,qBAAqB,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACxD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,gCAAgC,EAAE,CAAC;CAC5D"}

package/dist/esm/companion/provider-discovery.shared.schemas.js

@@ -2,7 +2,8 @@ import { z } from 'zod';
 import { AppFrontendType } from '../config/app-frontend-type.shared.schemas.js';
 import { EngineCapability } from '../external-providers/engine-capabilities.shared.schemas.js';
 import { FrontendProviderEntrySchema } from '../external-providers/frontend-bootstrap.shared.schemas.js';
-import { ProviderIdentitySchema } from '../external-providers/provider-metadata.shared.schemas.js';
+import { ProviderIdentitySchema, ProviderOriginSchema, ProviderTier } from '../external-providers/provider-metadata.shared.schemas.js';
+import { ProviderComplianceProfileSchema } from '../external-providers/provider-compliance-profile.shared.schemas.js';
 /**
  * Companion-safe provider implementation declaration.
  *
@@ -137,5 +138,87 @@ export const ProviderCompanionContributionSchema = z.looseObject({
      * concrete module instead of the whole package/runtime.
      */
     sourceModuleId: z.string().min(1).optional(),
+    /**
+     * The hosts the provider's OAuth2 TOKEN endpoint may resolve to (#1725) — derived by the producer with
+     * `describeProviderOAuth2TokenEndpointHosts`, absent when the provider runs no OAuth2 connected account.
+     *
+     * Carried so `wildo config sync` can refuse a declared shared connection whose member names a different
+     * authorization server than its base, without loading either module. Values-free: a login host is not a
+     * secret. Optional on the wire because a contribution emitted before #1725 carries none; the registry then
+     * makes the same comparison on the loaded modules at boot.
+     */
+    oauth2TokenEndpointHosts: z.strictObject({
+        exact: z.array(z.string().min(1)),
+        suffixes: z.array(z.string().min(1)),
+        undeterminable: z.boolean(),
+    }).optional(),
+    /**
+     * The secrets-contract SLUGS holding the provider's connected-account OAuth2 client registration — its client id
+     * and client secret (#1725). Absent when the provider runs no OAuth2 connected account.
+     *
+     * Carried so `wildo secrets` can tell an operator which registration a declared shared connection actually needs:
+     * the BASE's slots are then required, and a MEMBER's own slots are inert — reported, never required — because the
+     * base's client connects and refreshes the one grant.
+     */
+    oauth2ClientSlotSlugs: z.array(z.string().min(1)).optional(),
+    /**
+     * What the provider's BACKEND module declares about who runs it and where it processes (#1708) — ESTABLISHED
+     * facts, or UNDETERMINED. A frontend facet's profile rides `frontendEntry.complianceProfile` instead (#1743).
+     *
+     * Carried so the compliance readers (the evidence collector, the companion's drafting brief) learn every
+     * declared provider's profile from discovery, WITHOUT loading a provider module — the same reason
+     * `oauth2TokenEndpointHosts` is here. Values-free: a vendor's region list is not a secret. Optional on the wire
+     * because a contribution emitted before #1708 carries none, which a reader reports as "no profile".
+     */
+    complianceProfile: ProviderComplianceProfileSchema.optional(),
+});
+/**
+ * A package's declaration that it ADDS OPERATIONS to a provider it does not own (#1672).
+ *
+ * ## Why this is its own record and not a `ProviderCompanionContribution`
+ *
+ * A contribution says "this package OWNS provider X": identity, secrets contract, protocols, the runtimes
+ * it reaches. Discovery keeps one owner per ref and compares every contribution's secrets-contract shape
+ * against the others. An augmentation owns none of that — the base keeps identity, tier, secrets contract,
+ * OAuth2 block and connection — so recording it as a second contribution of the same ref would make the
+ * shape comparison treat it as a second owner, and the import map would pick one of the two by sort order.
+ * A separate record is what lets the base stay the base.
+ *
+ * ## What it carries, and why each field is STATIC
+ *
+ * `operationIds` and `requiredScopes` are stated here rather than read from the catalogue because a
+ * catalogue is a LAZY loader that tooling must never call (`ProviderRestOperationCatalogueLoader`). So
+ * `wildo config sync` can refuse an operation-id collision and record which scopes an augmentation may ask
+ * for without evaluating any vendor code; the runtime then checks that what the loader delivers is exactly
+ * what was declared here, and refuses the augmentation otherwise.
+ *
+ * INERT until an application opts it in under `providers.augmentations.<augments>` — installing a package
+ * never adds an operation to a provider on its own.
+ *
+ * Loose for the reason `ProviderCompanionContributionSchema` is: a newer producer's additive field must ride
+ * through an older consumer.
+ */
+export const ProviderAugmentationContributionSchema = z.looseObject({
+    /** The ref of the provider this package adds operations to — owned by the engine or another package. */
+    augments: z.string().min(1),
+    /** The augmentation package's own npm name, as its manifest states it. */
+    packageName: z.string().min(1),
+    /** Always `CATALOGUE`: an augmentation binds no engine slot and adds only operations. */
+    tier: z.literal(ProviderTier.CATALOGUE),
+    origin: ProviderOriginSchema,
+    /** The specifier a host imports to read the augmentation (`<package>/backend` by convention). */
+    runtimeImportPath: z.string().min(1),
+    /** Every operation id the augmentation contributes — sorted, unique, non-empty. */
+    operationIds: z.array(z.string().min(1)).min(1),
+    /** Every vendor scope any of those operations declares in `requiredScopes` — sorted, unique. */
+    requiredScopes: z.array(z.string().min(1)).default([]),
+}).superRefine((contribution, ctx) => {
+    for (const [field, values] of [['operationIds', contribution.operationIds], ['requiredScopes', contribution.requiredScopes]]) {
+        for (let index = 1; index < values.length; index += 1) {
+            if (values[index - 1].localeCompare(values[index]) >= 0) {
+                ctx.addIssue({ code: 'custom', path: [field, index], message: `${field} must be sorted and unique ("${values[index]}" follows "${values[index - 1]}").` });
+            }
+        }
+    }
 });
 //# sourceMappingURL=provider-discovery.shared.schemas.js.map

package/dist/esm/companion/provider-discovery.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-discovery.shared.schemas.js","sourceRoot":"","sources":["../../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { AppFrontendType } from '../config/app-frontend-type.shared.schemas';\nimport { EngineCapability } from '../external-providers/engine-capabilities.shared.schemas';\nimport { FrontendProviderEntrySchema } from '../external-providers/frontend-bootstrap.shared.schemas';\nimport { ProviderIdentitySchema } from '../external-providers/provider-metadata.shared.schemas';\n\n/**\n * Companion-safe provider implementation declaration.\n *\n * App/runtime-owner packages expose these entries through their `./companion`\n * default export so tooling can discover which provider refs are actually\n * reachable from which runtime owners before materializing generated artifacts.\n */\n\n/**\n * Discriminator branch for `frontendService` runtime targets.\n *\n * Targets a frontend service by its `AppFrontendType` (the closed kind set\n * — SAAS_APP, STATIC_WEBSITE, TECH_DOC) rather than by an app-defined\n * `serviceKey` string. Engine-shipped packages (`external-connectors-public`,\n * etc.) have no way to know app-defined service keys, so the discovery\n * contract is keyed on the type. Apps with multiple frontend services of\n * the same type currently broadcast the contribution to all of them; if\n * per-service-key targeting becomes a need, add a second variant.\n */\nexport const ProviderFrontendServiceRuntimeTargetSchema = z.strictObject({\n  kind: z.literal('frontendService'),\n  serviceType: z.enum(AppFrontendType),\n});\nexport type ProviderFrontendServiceRuntimeTarget = z.infer<typeof ProviderFrontendServiceRuntimeTargetSchema>;\n\nexport const ProviderCompanionRuntimeTargetSchema = z.discriminatedUnion('kind', [\n  z.strictObject({\n    kind: z.literal('backend'),\n  }),\n  z.strictObject({\n    kind: z.literal('companion'),\n  }),\n  ProviderFrontendServiceRuntimeTargetSchema,\n  z.strictObject({\n    kind: z.literal('minion'),\n    minionKey: z.string().min(1),\n  }),\n  z.strictObject({\n    kind: z.literal('worker'),\n    workerKey: z.string().min(1),\n  }),\n]);\nexport type ProviderCompanionRuntimeTarget = z.infer<typeof ProviderCompanionRuntimeTargetSchema>;\n\n/**\n * Values-free projection of one backend provider secret requirement.\n *\n * The stable provider-owned `slug` is preserved separately from the concrete\n * environment-variable name so a rename on either axis changes the lockfile\n * integrity digest. Secret values never cross this companion-safe boundary.\n */\nexport const ProviderSecretContractShapeEntrySchema = z.strictObject({\n  slug: z.string().min(1),\n  envVarName: z.string().min(1),\n  required: z.boolean(),\n  description: z.string().min(1),\n});\nexport type ProviderSecretContractShapeEntry = z.infer<typeof ProviderSecretContractShapeEntrySchema>;\n\n/**\n * Deterministic, values-free secret-contract shape used by provider discovery\n * and lockfile integrity checks.\n *\n * Every contribution must declare this field. `[]` means the provider is\n * authoritatively known to require no secrets; omission is rejected rather\n * than being silently interpreted as an empty contract. Entries must be\n * sorted by `slug`, and both slugs and environment-variable names are unique,\n * so independently contributed facets cannot produce order-dependent digests.\n */\nexport const ProviderSecretContractShapeSchema = z.array(ProviderSecretContractShapeEntrySchema).superRefine((entries, context) => {\n  const seenSlugs = new Set<string>();\n  const seenEnvVarNames = new Set<string>();\n\n  for (const [index, entry] of entries.entries()) {\n    if (seenSlugs.has(entry.slug)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: `Duplicate provider secret-contract slug \"${entry.slug}\".`,\n      });\n    }\n    seenSlugs.add(entry.slug);\n\n    if (seenEnvVarNames.has(entry.envVarName)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'envVarName'],\n        message: `Duplicate provider secret-contract envVarName \"${entry.envVarName}\".`,\n      });\n    }\n    seenEnvVarNames.add(entry.envVarName);\n\n    if (index > 0 && entries[index - 1].slug.localeCompare(entry.slug) >= 0) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: 'Provider secret-contract entries must be sorted by slug.',\n      });\n    }\n  }\n});\nexport type ProviderSecretContractShape = z.infer<typeof ProviderSecretContractShapeSchema>;\n\n/**\n * A contribution is a wire record produced by one package version and read by\n * another (the CLI, the companion, a generated artifact), so it is a LOOSE\n * object: an additive field from a newer producer rides through an older\n * consumer instead of hard-failing the parse (#328 — it used to be strict,\n * which made every additive field a five-surface change and every old/new\n * mix a boot failure). Required fields stay required; only UNKNOWN keys are\n * tolerated, and they are kept rather than stripped so a re-emitting\n * consumer does not silently drop what it did not understand.\n */\nexport const ProviderCompanionContributionSchema = z.looseObject({\n  ref: z.string().min(1),\n  /**\n   * The provider's identity (package, tier, vendor, origin) as declared on\n   * its module metadata, so tooling can display tiers and group vendors\n   * without loading the runtime module. Optional on the wire for one\n   * reason only: contributions emitted before #328 carry none, and a\n   * discovery walk must still read them.\n   */\n  identity: ProviderIdentitySchema.optional(),\n  /**\n   * Stable package import path that makes the provider implementation reachable\n   * from the contributing package at runtime. This validates owner-package\n   * reachability without coupling discovery to source-file paths.\n   */\n  runtimeImportPath: z.string().min(1),\n  runtimeTargets: z.array(ProviderCompanionRuntimeTargetSchema).min(1),\n  engineCapabilities: z.array(z.enum(EngineCapability)).default([]),\n  providerCapabilities: z.array(z.string().min(1)).default([]),\n  protocols: z.array(z.string().min(1)).default([]),\n  secretsContractShape: ProviderSecretContractShapeSchema,\n  /**\n   * Optional frontend-safe provider payload for `frontendService` runtime\n   * targets. Tooling materializes this into generated runtime artifacts so the\n   * backend bootstrap endpoint can serve app-owned public providers without\n   * importing frontend packages at runtime.\n   */\n  frontendEntry: FrontendProviderEntrySchema.optional(),\n  /**\n   * Optional app module owner when the provider implementation belongs to one\n   * concrete module instead of the whole package/runtime.\n   */\n  sourceModuleId: z.string().min(1).optional(),\n});\nexport type ProviderCompanionContribution = z.infer<typeof ProviderCompanionContributionSchema>;\n\nexport interface RuntimeOwnerCompanionExports {\n  providerContributions?: ProviderCompanionContribution[];\n}\n"]}
+{"version":3,"file":"provider-discovery.shared.schemas.js","sourceRoot":"","sources":["../../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { AppFrontendType } from '../config/app-frontend-type.shared.schemas';\nimport { EngineCapability } from '../external-providers/engine-capabilities.shared.schemas';\nimport { FrontendProviderEntrySchema } from '../external-providers/frontend-bootstrap.shared.schemas';\nimport { ProviderIdentitySchema, ProviderOriginSchema, ProviderTier } from '../external-providers/provider-metadata.shared.schemas';\nimport { ProviderComplianceProfileSchema } from '../external-providers/provider-compliance-profile.shared.schemas';\n\n/**\n * Companion-safe provider implementation declaration.\n *\n * App/runtime-owner packages expose these entries through their `./companion`\n * default export so tooling can discover which provider refs are actually\n * reachable from which runtime owners before materializing generated artifacts.\n */\n\n/**\n * Discriminator branch for `frontendService` runtime targets.\n *\n * Targets a frontend service by its `AppFrontendType` (the closed kind set\n * — SAAS_APP, STATIC_WEBSITE, TECH_DOC) rather than by an app-defined\n * `serviceKey` string. Engine-shipped packages (`external-connectors-public`,\n * etc.) have no way to know app-defined service keys, so the discovery\n * contract is keyed on the type. Apps with multiple frontend services of\n * the same type currently broadcast the contribution to all of them; if\n * per-service-key targeting becomes a need, add a second variant.\n */\nexport const ProviderFrontendServiceRuntimeTargetSchema = z.strictObject({\n  kind: z.literal('frontendService'),\n  serviceType: z.enum(AppFrontendType),\n});\nexport type ProviderFrontendServiceRuntimeTarget = z.infer<typeof ProviderFrontendServiceRuntimeTargetSchema>;\n\nexport const ProviderCompanionRuntimeTargetSchema = z.discriminatedUnion('kind', [\n  z.strictObject({\n    kind: z.literal('backend'),\n  }),\n  z.strictObject({\n    kind: z.literal('companion'),\n  }),\n  ProviderFrontendServiceRuntimeTargetSchema,\n  z.strictObject({\n    kind: z.literal('minion'),\n    minionKey: z.string().min(1),\n  }),\n  z.strictObject({\n    kind: z.literal('worker'),\n    workerKey: z.string().min(1),\n  }),\n]);\nexport type ProviderCompanionRuntimeTarget = z.infer<typeof ProviderCompanionRuntimeTargetSchema>;\n\n/**\n * Values-free projection of one backend provider secret requirement.\n *\n * The stable provider-owned `slug` is preserved separately from the concrete\n * environment-variable name so a rename on either axis changes the lockfile\n * integrity digest. Secret values never cross this companion-safe boundary.\n */\nexport const ProviderSecretContractShapeEntrySchema = z.strictObject({\n  slug: z.string().min(1),\n  envVarName: z.string().min(1),\n  required: z.boolean(),\n  description: z.string().min(1),\n});\nexport type ProviderSecretContractShapeEntry = z.infer<typeof ProviderSecretContractShapeEntrySchema>;\n\n/**\n * Deterministic, values-free secret-contract shape used by provider discovery\n * and lockfile integrity checks.\n *\n * Every contribution must declare this field. `[]` means the provider is\n * authoritatively known to require no secrets; omission is rejected rather\n * than being silently interpreted as an empty contract. Entries must be\n * sorted by `slug`, and both slugs and environment-variable names are unique,\n * so independently contributed facets cannot produce order-dependent digests.\n */\nexport const ProviderSecretContractShapeSchema = z.array(ProviderSecretContractShapeEntrySchema).superRefine((entries, context) => {\n  const seenSlugs = new Set<string>();\n  const seenEnvVarNames = new Set<string>();\n\n  for (const [index, entry] of entries.entries()) {\n    if (seenSlugs.has(entry.slug)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: `Duplicate provider secret-contract slug \"${entry.slug}\".`,\n      });\n    }\n    seenSlugs.add(entry.slug);\n\n    if (seenEnvVarNames.has(entry.envVarName)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'envVarName'],\n        message: `Duplicate provider secret-contract envVarName \"${entry.envVarName}\".`,\n      });\n    }\n    seenEnvVarNames.add(entry.envVarName);\n\n    if (index > 0 && entries[index - 1].slug.localeCompare(entry.slug) >= 0) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: 'Provider secret-contract entries must be sorted by slug.',\n      });\n    }\n  }\n});\nexport type ProviderSecretContractShape = z.infer<typeof ProviderSecretContractShapeSchema>;\n\n/**\n * A contribution is a wire record produced by one package version and read by\n * another (the CLI, the companion, a generated artifact), so it is a LOOSE\n * object: an additive field from a newer producer rides through an older\n * consumer instead of hard-failing the parse (#328 — it used to be strict,\n * which made every additive field a five-surface change and every old/new\n * mix a boot failure). Required fields stay required; only UNKNOWN keys are\n * tolerated, and they are kept rather than stripped so a re-emitting\n * consumer does not silently drop what it did not understand.\n */\nexport const ProviderCompanionContributionSchema = z.looseObject({\n  ref: z.string().min(1),\n  /**\n   * The provider's identity (package, tier, vendor, origin) as declared on\n   * its module metadata, so tooling can display tiers and group vendors\n   * without loading the runtime module. Optional on the wire for one\n   * reason only: contributions emitted before #328 carry none, and a\n   * discovery walk must still read them.\n   */\n  identity: ProviderIdentitySchema.optional(),\n  /**\n   * Stable package import path that makes the provider implementation reachable\n   * from the contributing package at runtime. This validates owner-package\n   * reachability without coupling discovery to source-file paths.\n   */\n  runtimeImportPath: z.string().min(1),\n  runtimeTargets: z.array(ProviderCompanionRuntimeTargetSchema).min(1),\n  engineCapabilities: z.array(z.enum(EngineCapability)).default([]),\n  providerCapabilities: z.array(z.string().min(1)).default([]),\n  protocols: z.array(z.string().min(1)).default([]),\n  secretsContractShape: ProviderSecretContractShapeSchema,\n  /**\n   * Optional frontend-safe provider payload for `frontendService` runtime\n   * targets. Tooling materializes this into generated runtime artifacts so the\n   * backend bootstrap endpoint can serve app-owned public providers without\n   * importing frontend packages at runtime.\n   */\n  frontendEntry: FrontendProviderEntrySchema.optional(),\n  /**\n   * Optional app module owner when the provider implementation belongs to one\n   * concrete module instead of the whole package/runtime.\n   */\n  sourceModuleId: z.string().min(1).optional(),\n  /**\n   * The hosts the provider's OAuth2 TOKEN endpoint may resolve to (#1725) — derived by the producer with\n   * `describeProviderOAuth2TokenEndpointHosts`, absent when the provider runs no OAuth2 connected account.\n   *\n   * Carried so `wildo config sync` can refuse a declared shared connection whose member names a different\n   * authorization server than its base, without loading either module. Values-free: a login host is not a\n   * secret. Optional on the wire because a contribution emitted before #1725 carries none; the registry then\n   * makes the same comparison on the loaded modules at boot.\n   */\n  oauth2TokenEndpointHosts: z.strictObject({\n    exact: z.array(z.string().min(1)),\n    suffixes: z.array(z.string().min(1)),\n    undeterminable: z.boolean(),\n  }).optional(),\n  /**\n   * The secrets-contract SLUGS holding the provider's connected-account OAuth2 client registration — its client id\n   * and client secret (#1725). Absent when the provider runs no OAuth2 connected account.\n   *\n   * Carried so `wildo secrets` can tell an operator which registration a declared shared connection actually needs:\n   * the BASE's slots are then required, and a MEMBER's own slots are inert — reported, never required — because the\n   * base's client connects and refreshes the one grant.\n   */\n  oauth2ClientSlotSlugs: z.array(z.string().min(1)).optional(),\n  /**\n   * What the provider's BACKEND module declares about who runs it and where it processes (#1708) — ESTABLISHED\n   * facts, or UNDETERMINED. A frontend facet's profile rides `frontendEntry.complianceProfile` instead (#1743).\n   *\n   * Carried so the compliance readers (the evidence collector, the companion's drafting brief) learn every\n   * declared provider's profile from discovery, WITHOUT loading a provider module — the same reason\n   * `oauth2TokenEndpointHosts` is here. Values-free: a vendor's region list is not a secret. Optional on the wire\n   * because a contribution emitted before #1708 carries none, which a reader reports as \"no profile\".\n   */\n  complianceProfile: ProviderComplianceProfileSchema.optional(),\n});\nexport type ProviderCompanionContribution = z.infer<typeof ProviderCompanionContributionSchema>;\n\n/**\n * A package's declaration that it ADDS OPERATIONS to a provider it does not own (#1672).\n *\n * ## Why this is its own record and not a `ProviderCompanionContribution`\n *\n * A contribution says \"this package OWNS provider X\": identity, secrets contract, protocols, the runtimes\n * it reaches. Discovery keeps one owner per ref and compares every contribution's secrets-contract shape\n * against the others. An augmentation owns none of that — the base keeps identity, tier, secrets contract,\n * OAuth2 block and connection — so recording it as a second contribution of the same ref would make the\n * shape comparison treat it as a second owner, and the import map would pick one of the two by sort order.\n * A separate record is what lets the base stay the base.\n *\n * ## What it carries, and why each field is STATIC\n *\n * `operationIds` and `requiredScopes` are stated here rather than read from the catalogue because a\n * catalogue is a LAZY loader that tooling must never call (`ProviderRestOperationCatalogueLoader`). So\n * `wildo config sync` can refuse an operation-id collision and record which scopes an augmentation may ask\n * for without evaluating any vendor code; the runtime then checks that what the loader delivers is exactly\n * what was declared here, and refuses the augmentation otherwise.\n *\n * INERT until an application opts it in under `providers.augmentations.<augments>` — installing a package\n * never adds an operation to a provider on its own.\n *\n * Loose for the reason `ProviderCompanionContributionSchema` is: a newer producer's additive field must ride\n * through an older consumer.\n */\nexport const ProviderAugmentationContributionSchema = z.looseObject({\n  /** The ref of the provider this package adds operations to — owned by the engine or another package. */\n  augments: z.string().min(1),\n  /** The augmentation package's own npm name, as its manifest states it. */\n  packageName: z.string().min(1),\n  /** Always `CATALOGUE`: an augmentation binds no engine slot and adds only operations. */\n  tier: z.literal(ProviderTier.CATALOGUE),\n  origin: ProviderOriginSchema,\n  /** The specifier a host imports to read the augmentation (`<package>/backend` by convention). */\n  runtimeImportPath: z.string().min(1),\n  /** Every operation id the augmentation contributes — sorted, unique, non-empty. */\n  operationIds: z.array(z.string().min(1)).min(1),\n  /** Every vendor scope any of those operations declares in `requiredScopes` — sorted, unique. */\n  requiredScopes: z.array(z.string().min(1)).default([]),\n}).superRefine((contribution, ctx) => {\n  for (const [field, values] of [['operationIds', contribution.operationIds], ['requiredScopes', contribution.requiredScopes]] as const) {\n    for (let index = 1; index < values.length; index += 1) {\n      if (values[index - 1].localeCompare(values[index]) >= 0) {\n        ctx.addIssue({ code: 'custom', path: [field, index], message: `${field} must be sorted and unique (\"${values[index]}\" follows \"${values[index - 1]}\").` });\n      }\n    }\n  }\n});\nexport type ProviderAugmentationContribution = z.infer<typeof ProviderAugmentationContributionSchema>;\n\nexport interface RuntimeOwnerCompanionExports {\n  providerContributions?: ProviderCompanionContribution[];\n  /**\n   * Operation augmentations of providers this package does not own (#1672). Separate from\n   * `providerContributions` on purpose — see {@link ProviderAugmentationContributionSchema}.\n   */\n  providerAugmentations?: ProviderAugmentationContribution[];\n}\n"]}

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.d.ts

@@ -85,8 +85,21 @@ export declare const applicationAuditLogsResourceConfiguration_InitializationFac
     correlationId: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
     frontendServiceName: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
     clientInstanceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>>;
+    actorKind: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./audit-actor.shared.schemas").AuditActorKind>>>>>;
+    agentActor: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodObject<{
+        agentRef: z.ZodString;
+        agentExecutionId: z.ZodOptional<z.ZodString>;
+        systemRef: z.ZodOptional<z.ZodString>;
+        toolName: z.ZodOptional<z.ZodString>;
+        decisionRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    delegatingClientId: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    principalCredentialId: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    actingViaServiceProviderRelationshipId: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
+    providerOrganizationId: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    serviceProviderFactorSource: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("../..").FactorSatisfactionSource>>>>;
     riskLevel: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof ResourceOperationRiskLevel>>;
-    eventType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    eventType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
     eventData: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodRecord<z.ZodString, z.ZodAny>>;
     eventCategory: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof AuditEventCategory>>;
     severity: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof AuditEventSeverity>>;

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAA6B,MAAM,kCAAkC,CAAC;AAErH,OAAO,EAAE,qBAAqB,EAAwD,MAAM,mDAAmD,CAAC;AAChJ,OAAO,EAAE,0BAA0B,EAAgC,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAC1I,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAGpF;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAAS,cAAc,EAGpE,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,+DAA+D,GAC1E,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;kBA+F9C,CAAC"}
+{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAA6B,MAAM,kCAAkC,CAAC;AAErH,OAAO,EAAE,qBAAqB,EAAwD,MAAM,mDAAmD,CAAC;AAChJ,OAAO,EAAE,0BAA0B,EAAgC,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAC1I,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAGpF;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAAS,cAAc,EAGpE,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,+DAA+D,GAC1E,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmG9C,CAAC"}

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.js

@@ -133,6 +133,8 @@ export const applicationAuditLogsResourceConfiguration_InitializationFactory = (
                          */
                         organizationId: z.string(),
                         correlationId: z.string(),
+                        // #1597 — "what did firm X do here?": a client filters its own trail by the relationship its firm acted through.
+                        actingViaServiceProviderRelationshipId: z.string(),
                         clientInstanceId: z.string(),
                         createdAt: z.date(),
                     },
@@ -159,6 +161,8 @@ export const applicationAuditLogsResourceConfiguration_InitializationFactory = (
                         userId: z.string(),
                         organizationId: z.string(),
                         correlationId: z.string(),
+                        // #1597 — "what did firm X do here?": a client filters its own trail by the relationship its firm acted through.
+                        actingViaServiceProviderRelationshipId: z.string(),
                         clientInstanceId: z.string(),
                         createdAt: z.date(),
                     },

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { AuditEventCategory, AuditEventSeverity, AuditableEvent_BaseSchema } from './auditable-events.shared.schema';\nimport { createResourceConfiguration_Initialization } from '../../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceRelationship } from '../../resources/resources.shared.schemas';\nimport { CORE_APP_ROLES } from '../../security/authorizations/roles.shared.schemas';\nimport { ResourceSystemAccessMode } from '../../resources/resources-config.shared.schemas';\n\n/**\n * The roles the application audit door's READ, LIST and SEARCH accept — ONE list, so the three verbs\n * cannot disagree about who may read the trail.\n *\n * `APP_ADMIN_SUPER_ADMIN` for the operator who investigates and then acts; `APP_AUDIT_EVIDENCE_READER`\n * for a party that must read and must NOT act — an assurance collector's machine credential, an\n * external auditor. Neither is an organization role: the rows behind this door span every tenant.\n */\nexport const APPLICATION_AUDIT_LOG_READ_ROLES: readonly CORE_APP_ROLES[] = Object.freeze([\n  CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN,\n  CORE_APP_ROLES.APP_AUDIT_EVIDENCE_READER,\n]);\n\n/**\n * The APPLICATION-scoped door onto the audit trail.\n *\n * ## Why this exists at all\n *\n * `AUDIT_LOGS` is organization-scoped and its only route is\n * `/organizations/{organizationId}/audit-logs`, so it returns exactly the rows carrying that\n * tenant. A large share of security events carry NO organization by design — `logUserLogin` takes\n * `organizationId` as optional because no organization is selected at login, and the same is true\n * of session eviction, token refresh and application-wide authentication-policy changes. Measured\n * on a dogfood application (#317): **94 of 127 rows had no organization**, and were reachable\n * through no API. An operator could see 26% of the trail and could not attest the rest, while a\n * reader querying the only available surface saw `user_login: 0` for a control that had emitted 21.\n *\n * ## Why a SEPARATE resource type rather than a second route\n *\n * `generateParentCombinations` composes every URL as\n * `[...primaryScope, ...mandatoryContext, ...optionalCombo]`, so a routed application edge on\n * `AUDIT_LOGS` would appear in EVERY combination and rewrite the organization route to\n * `/applications/{applicationId}/organizations/{organizationId}/audit-logs` — breaking all eight of\n * its documented paths and their consumers. Making the organization edge optional does not help:\n * the empty combination is skipped whenever any parent exists, so no bare route is emitted either.\n * A sibling type carrying ONE application parent takes the route it needs and leaves the existing\n * door byte-identical. The pattern is the engine's own: notification badges are dual-scope with a\n * type per scope, `APPLICATION_API_KEYS` shows the application routing shape, and `USER_SELF`\n * shows a distinct type addressing another's rows.\n *\n * ## Two doors, ONE record set — the security contract\n *\n * Both types resolve to the `auditLogs` collection through\n * `RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES`. That makes the isolation properties a\n * per-DOOR obligation rather than a property of the rows:\n *\n * - the organization door keeps its tenant filter and its organization roles, unchanged;\n * - this door accepts {@link APPLICATION_AUDIT_LOG_READ_ROLES} and nothing else — `APP_ADMIN_SUPER_ADMIN`\n *   or the read-only `APP_AUDIT_EVIDENCE_READER`. An organization role must never reach it — the rows\n *   behind it span every tenant;\n * - a read here that touches a tenant-attributed row is a CROSS-TENANT read and OWES an audit\n *   emission. **It is wired**, by the two halves below acting together, and neither is optional:\n *   each read variant declares `admitsCrossTenantPlatformAdministration`, and\n *   `ServicesRegistryHandler.recordCrossTenantReadAccess` observes every enrolled read and emits\n *   `CROSS_TENANT_ADMINISTRATIVE_ACCESS` once per TENANT the returned rows belong to. The\n *   declaration is what enrols the read: `authorizeOrganizations` — where that event is otherwise\n *   emitted — runs only for ORGANIZATIONS-scoped resources and decides on ONE fetched row, so it\n *   never sees this door at all. Grouping per tenant is what makes the crossing visible to the\n *   REACHED tenant, in its own organization-scoped viewer, rather than only to the operator.\n *   `.claude/rules/administrative-continuity-floors.md` requires every crossing to be named in the\n *   trail, and the trail is the worst possible surface on which to make an operator read invisible.\n *   See `security/authorizations/cross-tenant-read-observation.backend.ts` for why an UNDECLARED\n *   door is deliberately not observed instead of being observed with a false `admissionDeclared`.\n *\n * ## Deliberately mirrored from the organization resource\n *\n * `isSystemResource`, `systemAccessPolicy.exportSubject: FORBIDDEN` and the ABSENCE of a\n * `retentionPolicy` are copied ON PURPOSE. They are properties of the ROWS, and the rows are the\n * same ones — a second door that disagreed about whether the audit trail is subject-exportable, or\n * about how long it is kept, would be a policy fork over one record set. See the organization\n * config for the reasoning behind each; do not change one without the other.\n *\n * ## Deliberately NOT mirrored\n *\n * There is no CREATE. The organization resource carries a `REPOSITORY_ONLY` CREATE because that is\n * how audit rows are written; writing is not a scope question and must keep exactly one door.\n */\nexport const applicationAuditLogsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  undefined,\n  CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.SEARCH,\n  typeof AuditableEvent_BaseSchema\n>({\n  mainSchema: AuditableEvent_BaseSchema,\n  resourceIdentifier: CoreResourceType.APPLICATION_AUDIT_LOGS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION_AUDIT_LOGS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  /** Mirrored from the organization door — the same rows, so the same answer. Disclosing the monitoring trail to its own subject is self-defeating and out of Art. 20 scope. */\n  systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.FORBIDDEN },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n  ],\n\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /**\n         * Reading ONE tenant's audit row through the application door IS a crossing, so the cheapest\n         * reach — fetch by id — is declared and audited exactly like the collection verbs. Declaring\n         * it is also what stops `assignInitiatorOrganizationConfinementToFilter` silently narrowing\n         * this door to an operator who happens to carry an ambient organization, which would make a\n         * surface documented as spanning every tenant return one tenant and report success.\n         */\n        admitsCrossTenantPlatformAdministration: true,\n      }],\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          /**\n           * Filterable so an operator can narrow to one tenant THROUGH this door, which is the\n           * cross-tenant investigation this surface exists for. It is a FILTER, never the isolation\n           * boundary: isolation on this door is the role gate above, and narrowing to a tenant does\n           * not make the read any less cross-tenant for audit purposes.\n           */\n          organizationId: z.string(),\n          correlationId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        /** `eventId` last, as the keyset tie-breaker — `createdAt` is not unique under boot/seed bursts. Mirrors the organization door; removing it reintroduces a paging data-loss path. */\n        sortFields: ['createdAt', 'severity', 'eventType', 'eventId'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        isSearchable: true,\n        searchableFields: [],\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          organizationId: z.string(),\n          correlationId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        sortFields: ['createdAt', 'severity', 'eventType'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n  },\n});\n"]}
+{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { AuditEventCategory, AuditEventSeverity, AuditableEvent_BaseSchema } from './auditable-events.shared.schema';\nimport { createResourceConfiguration_Initialization } from '../../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceRelationship } from '../../resources/resources.shared.schemas';\nimport { CORE_APP_ROLES } from '../../security/authorizations/roles.shared.schemas';\nimport { ResourceSystemAccessMode } from '../../resources/resources-config.shared.schemas';\n\n/**\n * The roles the application audit door's READ, LIST and SEARCH accept — ONE list, so the three verbs\n * cannot disagree about who may read the trail.\n *\n * `APP_ADMIN_SUPER_ADMIN` for the operator who investigates and then acts; `APP_AUDIT_EVIDENCE_READER`\n * for a party that must read and must NOT act — an assurance collector's machine credential, an\n * external auditor. Neither is an organization role: the rows behind this door span every tenant.\n */\nexport const APPLICATION_AUDIT_LOG_READ_ROLES: readonly CORE_APP_ROLES[] = Object.freeze([\n  CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN,\n  CORE_APP_ROLES.APP_AUDIT_EVIDENCE_READER,\n]);\n\n/**\n * The APPLICATION-scoped door onto the audit trail.\n *\n * ## Why this exists at all\n *\n * `AUDIT_LOGS` is organization-scoped and its only route is\n * `/organizations/{organizationId}/audit-logs`, so it returns exactly the rows carrying that\n * tenant. A large share of security events carry NO organization by design — `logUserLogin` takes\n * `organizationId` as optional because no organization is selected at login, and the same is true\n * of session eviction, token refresh and application-wide authentication-policy changes. Measured\n * on a dogfood application (#317): **94 of 127 rows had no organization**, and were reachable\n * through no API. An operator could see 26% of the trail and could not attest the rest, while a\n * reader querying the only available surface saw `user_login: 0` for a control that had emitted 21.\n *\n * ## Why a SEPARATE resource type rather than a second route\n *\n * `generateParentCombinations` composes every URL as\n * `[...primaryScope, ...mandatoryContext, ...optionalCombo]`, so a routed application edge on\n * `AUDIT_LOGS` would appear in EVERY combination and rewrite the organization route to\n * `/applications/{applicationId}/organizations/{organizationId}/audit-logs` — breaking all eight of\n * its documented paths and their consumers. Making the organization edge optional does not help:\n * the empty combination is skipped whenever any parent exists, so no bare route is emitted either.\n * A sibling type carrying ONE application parent takes the route it needs and leaves the existing\n * door byte-identical. The pattern is the engine's own: notification badges are dual-scope with a\n * type per scope, `APPLICATION_API_KEYS` shows the application routing shape, and `USER_SELF`\n * shows a distinct type addressing another's rows.\n *\n * ## Two doors, ONE record set — the security contract\n *\n * Both types resolve to the `auditLogs` collection through\n * `RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES`. That makes the isolation properties a\n * per-DOOR obligation rather than a property of the rows:\n *\n * - the organization door keeps its tenant filter and its organization roles, unchanged;\n * - this door accepts {@link APPLICATION_AUDIT_LOG_READ_ROLES} and nothing else — `APP_ADMIN_SUPER_ADMIN`\n *   or the read-only `APP_AUDIT_EVIDENCE_READER`. An organization role must never reach it — the rows\n *   behind it span every tenant;\n * - a read here that touches a tenant-attributed row is a CROSS-TENANT read and OWES an audit\n *   emission. **It is wired**, by the two halves below acting together, and neither is optional:\n *   each read variant declares `admitsCrossTenantPlatformAdministration`, and\n *   `ServicesRegistryHandler.recordCrossTenantReadAccess` observes every enrolled read and emits\n *   `CROSS_TENANT_ADMINISTRATIVE_ACCESS` once per TENANT the returned rows belong to. The\n *   declaration is what enrols the read: `authorizeOrganizations` — where that event is otherwise\n *   emitted — runs only for ORGANIZATIONS-scoped resources and decides on ONE fetched row, so it\n *   never sees this door at all. Grouping per tenant is what makes the crossing visible to the\n *   REACHED tenant, in its own organization-scoped viewer, rather than only to the operator.\n *   `.claude/rules/administrative-continuity-floors.md` requires every crossing to be named in the\n *   trail, and the trail is the worst possible surface on which to make an operator read invisible.\n *   See `security/authorizations/cross-tenant-read-observation.backend.ts` for why an UNDECLARED\n *   door is deliberately not observed instead of being observed with a false `admissionDeclared`.\n *\n * ## Deliberately mirrored from the organization resource\n *\n * `isSystemResource`, `systemAccessPolicy.exportSubject: FORBIDDEN` and the ABSENCE of a\n * `retentionPolicy` are copied ON PURPOSE. They are properties of the ROWS, and the rows are the\n * same ones — a second door that disagreed about whether the audit trail is subject-exportable, or\n * about how long it is kept, would be a policy fork over one record set. See the organization\n * config for the reasoning behind each; do not change one without the other.\n *\n * ## Deliberately NOT mirrored\n *\n * There is no CREATE. The organization resource carries a `REPOSITORY_ONLY` CREATE because that is\n * how audit rows are written; writing is not a scope question and must keep exactly one door.\n */\nexport const applicationAuditLogsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  undefined,\n  CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.SEARCH,\n  typeof AuditableEvent_BaseSchema\n>({\n  mainSchema: AuditableEvent_BaseSchema,\n  resourceIdentifier: CoreResourceType.APPLICATION_AUDIT_LOGS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION_AUDIT_LOGS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  /** Mirrored from the organization door — the same rows, so the same answer. Disclosing the monitoring trail to its own subject is self-defeating and out of Art. 20 scope. */\n  systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.FORBIDDEN },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n  ],\n\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /**\n         * Reading ONE tenant's audit row through the application door IS a crossing, so the cheapest\n         * reach — fetch by id — is declared and audited exactly like the collection verbs. Declaring\n         * it is also what stops `assignInitiatorOrganizationConfinementToFilter` silently narrowing\n         * this door to an operator who happens to carry an ambient organization, which would make a\n         * surface documented as spanning every tenant return one tenant and report success.\n         */\n        admitsCrossTenantPlatformAdministration: true,\n      }],\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          /**\n           * Filterable so an operator can narrow to one tenant THROUGH this door, which is the\n           * cross-tenant investigation this surface exists for. It is a FILTER, never the isolation\n           * boundary: isolation on this door is the role gate above, and narrowing to a tenant does\n           * not make the read any less cross-tenant for audit purposes.\n           */\n          organizationId: z.string(),\n          correlationId: z.string(),\n          // #1597 — \"what did firm X do here?\": a client filters its own trail by the relationship its firm acted through.\n          actingViaServiceProviderRelationshipId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        /** `eventId` last, as the keyset tie-breaker — `createdAt` is not unique under boot/seed bursts. Mirrors the organization door; removing it reintroduces a paging data-loss path. */\n        sortFields: ['createdAt', 'severity', 'eventType', 'eventId'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        isSearchable: true,\n        searchableFields: [],\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          organizationId: z.string(),\n          correlationId: z.string(),\n          // #1597 — \"what did firm X do here?\": a client filters its own trail by the relationship its firm acted through.\n          actingViaServiceProviderRelationshipId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        sortFields: ['createdAt', 'severity', 'eventType'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n  },\n});\n"]}

package/dist/esm/compliance/audit-trails/audit-actor.shared.schemas.d.ts

@@ -27,6 +27,7 @@
  * assurance-control: WILDO.AUDIT.ATTRIBUTION — a security-relevant action must record who performed
  * it, and must not disguise an unattributable action as an ordinary automated one.
  */
+import { z } from 'zod';
 /**
  * Sentinel actors for audit `*By` fields. Resolve one with
  * `resolveAuditActorId(executionContext)` from `@wildo-ai/saas-backend-lib` rather than choosing by
@@ -62,4 +63,73 @@ export declare const AUDIT_ACTOR_SENTINELS: readonly string[];
  * `=== 'system'` silently stops matching if the vocabulary grows.
  */
 export declare function isAuditActorSentinel(actorId: string): boolean;
+/** @wildo_source:part:start saas.models.audit-trails.actor-attribution facet:layer:shared facet:family:audit-trails facet:audience:app-developer */
+/**
+ * The KIND of principal whose authority an audited action used — recorded on every audit row as
+ * `actorKind`, beside `userId`.
+ *
+ * It answers ONE question and nothing else: *under whose authority did this happen?* Whether an AI
+ * agent performed the action is a different question, answered by the presence of the row's
+ * `agentActor` ({@link AuditAgentActorSchema}). An agent is never a principal: it always acts under a
+ * user's, a machine's, or the application's own authority, so there is deliberately no `AGENT` member.
+ * Folding the two into one field would make it answer two questions and a reader could no longer tell
+ * "the user did it" from "an agent did it with the user's authority".
+ *
+ * The framework fills it on every row, so an application never writes it. An application emitting its
+ * own event through `AuditLogsBackendService.logEvent` passes its request context, and with none names
+ * the principal instead: `userAuditPrincipal(userId)`, `SYSTEM_AUDIT_PRINCIPAL`,
+ * `UNAUTHENTICATED_AUDIT_PRINCIPAL` or `machineCredentialAuditPrincipal(...)`, all exported by
+ * `@wildo-ai/saas-backend-lib`. With neither, the kind is read off the `userId` the event carries — right
+ * only when that id is the actor, not the subject.
+ *
+ * assurance-control: WILDO.AUDIT.ATTRIBUTION — every audit row names the kind of principal whose
+ * authority was used, so an unattributed action stays distinguishable from routine automation.
+ */
+export declare enum AuditActorKind {
+    /** A signed-in person acting through a first-party session. `userId` is that person. */
+    USER = "user",
+    /**
+     * A person's authority, exercised by an EXTERNAL OAuth client they delegated to (an A2A or MCP
+     * client). `userId` is the delegating person and `delegatingClientId` names the client, taken from
+     * the verified token's `azp`.
+     */
+    DELEGATED_CLIENT = "delegated_client",
+    /** An organization or application machine credential (API key or OAuth client credentials). `principalCredentialId` names it. */
+    MACHINE = "machine",
+    /**
+     * The application acting on its own behalf by design — a batch, a cron job, an internal workflow, a
+     * system-door read or write, or application code handling a signature-verified inbound message or
+     * webhook (the sender holds a shared secret, not a credential this application issued).
+     */
+    SYSTEM = "system",
+    /**
+     * Nobody was authenticated, and none was expected: a sign-in or recovery attempt before any factor
+     * succeeded, a public operation, an anonymous visitor session. Routine traffic — kept apart from
+     * `UNATTRIBUTED` so that a failed login is not reported as the anomaly reviewers alert on.
+     */
+    UNAUTHENTICATED = "unauthenticated",
+    /** A principal was expected and could not be resolved. The anomaly a reviewer should alert on. */
+    UNATTRIBUTED = "unattributed"
+}
+/**
+ * Which AI agent performed an audited action, and in which execution — present on an audit row ONLY
+ * when an agent acted. Its presence is how the trail says "an agent did this"; `actorKind` still names
+ * the principal whose authority the agent used.
+ *
+ * Evidence only: nothing in the framework authorizes on it. It carries identifiers, never the
+ * conversation's text, the tool's argument values, or digests of them — a digest of a short argument
+ * can be reversed by enumeration, and the audit ledger cannot be scrubbed.
+ *
+ * Filled by the framework: every write an agent's tool makes — through a resource tool, a hand-written
+ * tool, or a system write inside a tool — carries it automatically.
+ */
+export declare const AuditAgentActorSchema: z.ZodObject<{
+    agentRef: z.ZodString;
+    agentExecutionId: z.ZodOptional<z.ZodString>;
+    systemRef: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodOptional<z.ZodString>;
+    decisionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AuditAgentActor = z.infer<typeof AuditAgentActorSchema>;
+/** @wildo_source:part:end saas.models.audit-trails.actor-attribution */
 //# sourceMappingURL=audit-actor.shared.schemas.d.ts.map

package/dist/esm/compliance/audit-trails/audit-actor.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-actor.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-actor.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;GAIG;AACH,oBAAY,kBAAkB;IAC5B;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;;OAKG;IACH,OAAO,YAAY;IACnB;;;;OAIG;IACH,YAAY,iBAAiB;CAC9B;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAqD,CAAC;AAEzG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D"}
+{"version":3,"file":"audit-actor.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-actor.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,oBAAY,kBAAkB;IAC5B;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;;OAKG;IACH,OAAO,YAAY;IACnB;;;;OAIG;IACH,YAAY,iBAAiB;CAC9B;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAqD,CAAC;AAEzG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,oJAAoJ;AACpJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,oBAAY,cAAc;IACxB,wFAAwF;IACxF,IAAI,SAAS;IACb;;;;OAIG;IACH,gBAAgB,qBAAqB;IACrC,iIAAiI;IACjI,OAAO,YAAY;IACnB;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;OAIG;IACH,eAAe,oBAAoB;IACnC,kGAAkG;IAClG,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAuBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,wEAAwE"}