@spacefast/common 0.2.1 → 0.4.1

package/dist/contracts/superadmin-connectors.d.ts

@@ -0,0 +1,371 @@
+import { z } from "zod";
+/**
+ * The superadmin read of connector runs across every team: the inbox support
+ * opens when a customer reports a stuck or refused call. Reads only; a run is
+ * decided by the person policy named, never from here.
+ */
+export declare const superadminConnectorRunListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    search: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        expired: "expired";
+        running: "running";
+        succeeded: "succeeded";
+        awaiting_approval: "awaiting_approval";
+    }>>;
+    teamId: z.ZodOptional<z.ZodString>;
+    origin: z.ZodOptional<z.ZodEnum<{
+        function: "function";
+        zero: "zero";
+        api: "api";
+        dashboard: "dashboard";
+        mcp: "mcp";
+        cli: "cli";
+        system: "system";
+    }>>;
+    space: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SuperadminConnectorRunSchema: z.ZodObject<{
+    origin: z.ZodEnum<{
+        function: "function";
+        zero: "zero";
+        api: "api";
+        dashboard: "dashboard";
+        mcp: "mcp";
+        cli: "cli";
+        system: "system";
+    }>;
+    space: z.ZodNullable<z.ZodString>;
+    handler: z.ZodNullable<z.ZodString>;
+    visitor: z.ZodBoolean;
+    id: z.ZodString;
+    team: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        slug: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodEnum<{
+        tool: "tool";
+        code: "code";
+    }>;
+    address: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        expired: "expired";
+        running: "running";
+        succeeded: "succeeded";
+        awaiting_approval: "awaiting_approval";
+    }>;
+    errorCode: z.ZodNullable<z.ZodString>;
+    actorUserId: z.ZodNullable<z.ZodString>;
+    credentialId: z.ZodNullable<z.ZodString>;
+    decisionId: z.ZodNullable<z.ZodString>;
+    approval: z.ZodNullable<z.ZodObject<{
+        mode: z.ZodEnum<{
+            model: "model";
+            human: "human";
+        }>;
+        address: z.ZodString;
+        reason: z.ZodString;
+        expiresAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    toolCalls: z.ZodNumber;
+    egressBytes: z.ZodNumber;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SuperadminConnectorRun = z.infer<typeof SuperadminConnectorRunSchema>;
+export declare const SuperadminTeamConnectorsSchema: z.ZodObject<{
+    connectorsServing: z.ZodDefault<z.ZodObject<{
+        adminOnly: z.ZodBoolean;
+        allowlist: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    team: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+    }, z.core.$strip>;
+    spaces: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>;
+    visitorConnections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        spaceId: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    connectors: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        source: z.ZodEnum<{
+            mcp: "mcp";
+            openapi: "openapi";
+            graphql: "graphql";
+        }>;
+        catalogSource: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"openapi">;
+            spec: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"graphql">;
+            endpoint: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"mcp">;
+            endpoint: z.ZodString;
+        }, z.core.$strip>], "kind">>;
+        sourceUrl: z.ZodNullable<z.ZodString>;
+        firstParty: z.ZodBoolean;
+        presetId: z.ZodNullable<z.ZodString>;
+        authMethods: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"api_key">;
+            slug: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"oauth2">;
+            slug: z.ZodString;
+            label: z.ZodString;
+            scopes: z.ZodArray<z.ZodString>;
+            clientIdMetadataDocument: z.ZodOptional<z.ZodBoolean>;
+            dynamicRegistration: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"none">;
+            slug: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"first_party">;
+            slug: z.ZodString;
+            label: z.ZodString;
+            provider: z.ZodString;
+        }, z.core.$strip>], "kind">>;
+        toolCount: z.ZodNumber;
+        connections: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            connector: z.ZodString;
+            owner: z.ZodEnum<{
+                team: "team";
+                personal: "personal";
+            }>;
+            serving: z.ZodDefault<z.ZodBoolean>;
+            displayName: z.ZodString;
+            description: z.ZodNullable<z.ZodString>;
+            status: z.ZodEnum<{
+                active: "active";
+                revoked: "revoked";
+                degraded: "degraded";
+                pending_authorization: "pending_authorization";
+                needs_reauth: "needs_reauth";
+            }>;
+            identityLabel: z.ZodNullable<z.ZodString>;
+            credentialConfigured: z.ZodBoolean;
+            authMethod: z.ZodNullable<z.ZodString>;
+            scopes: z.ZodArray<z.ZodString>;
+            isDefault: z.ZodBoolean;
+            toolCount: z.ZodNumber;
+            createdBy: z.ZodNullable<z.ZodString>;
+            lastCheckedAt: z.ZodNullable<z.ZodString>;
+            revokedAt: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        specSyncedAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    policies: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        pattern: z.ZodString;
+        action: z.ZodEnum<{
+            approve: "approve";
+            require_approval: "require_approval";
+            block: "block";
+        }>;
+        owner: z.ZodEnum<{
+            team: "team";
+            personal: "personal";
+        }>;
+        position: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    runs: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        origin: z.ZodEnum<{
+            function: "function";
+            zero: "zero";
+            api: "api";
+            dashboard: "dashboard";
+            mcp: "mcp";
+            cli: "cli";
+            system: "system";
+        }>;
+        space: z.ZodNullable<z.ZodString>;
+        handler: z.ZodNullable<z.ZodString>;
+        visitor: z.ZodBoolean;
+        id: z.ZodString;
+        input: z.ZodObject<{
+            kind: z.ZodEnum<{
+                tool: "tool";
+                code: "code";
+            }>;
+            address: z.ZodNullable<z.ZodString>;
+            digest: z.ZodString;
+        }, z.core.$strip>;
+        usage: z.ZodObject<{
+            toolCalls: z.ZodNumber;
+            egressBytes: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+        createdAt: z.ZodString;
+        status: z.ZodLiteral<"running">;
+    }, z.core.$strip>, z.ZodObject<{
+        origin: z.ZodEnum<{
+            function: "function";
+            zero: "zero";
+            api: "api";
+            dashboard: "dashboard";
+            mcp: "mcp";
+            cli: "cli";
+            system: "system";
+        }>;
+        space: z.ZodNullable<z.ZodString>;
+        handler: z.ZodNullable<z.ZodString>;
+        visitor: z.ZodBoolean;
+        id: z.ZodString;
+        input: z.ZodObject<{
+            kind: z.ZodEnum<{
+                tool: "tool";
+                code: "code";
+            }>;
+            address: z.ZodNullable<z.ZodString>;
+            digest: z.ZodString;
+        }, z.core.$strip>;
+        usage: z.ZodObject<{
+            toolCalls: z.ZodNumber;
+            egressBytes: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+        createdAt: z.ZodString;
+        status: z.ZodLiteral<"awaiting_approval">;
+        approval: z.ZodObject<{
+            decisionId: z.ZodNullable<z.ZodString>;
+            mode: z.ZodEnum<{
+                model: "model";
+                human: "human";
+            }>;
+            address: z.ZodString;
+            preview: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            reason: z.ZodEnum<{
+                policy_require_approval: "policy_require_approval";
+                annotation_requires_approval: "annotation_requires_approval";
+            }>;
+            matchedPattern: z.ZodNullable<z.ZodString>;
+            approvalUrl: z.ZodString;
+            expiresAt: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        origin: z.ZodEnum<{
+            function: "function";
+            zero: "zero";
+            api: "api";
+            dashboard: "dashboard";
+            mcp: "mcp";
+            cli: "cli";
+            system: "system";
+        }>;
+        space: z.ZodNullable<z.ZodString>;
+        handler: z.ZodNullable<z.ZodString>;
+        visitor: z.ZodBoolean;
+        id: z.ZodString;
+        input: z.ZodObject<{
+            kind: z.ZodEnum<{
+                tool: "tool";
+                code: "code";
+            }>;
+            address: z.ZodNullable<z.ZodString>;
+            digest: z.ZodString;
+        }, z.core.$strip>;
+        usage: z.ZodObject<{
+            toolCalls: z.ZodNumber;
+            egressBytes: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+        createdAt: z.ZodString;
+        status: z.ZodLiteral<"succeeded">;
+        completedAt: z.ZodString;
+        result: z.ZodUnknown;
+    }, z.core.$strip>, z.ZodObject<{
+        origin: z.ZodEnum<{
+            function: "function";
+            zero: "zero";
+            api: "api";
+            dashboard: "dashboard";
+            mcp: "mcp";
+            cli: "cli";
+            system: "system";
+        }>;
+        space: z.ZodNullable<z.ZodString>;
+        handler: z.ZodNullable<z.ZodString>;
+        visitor: z.ZodBoolean;
+        id: z.ZodString;
+        input: z.ZodObject<{
+            kind: z.ZodEnum<{
+                tool: "tool";
+                code: "code";
+            }>;
+            address: z.ZodNullable<z.ZodString>;
+            digest: z.ZodString;
+        }, z.core.$strip>;
+        usage: z.ZodObject<{
+            toolCalls: z.ZodNumber;
+            egressBytes: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+        createdAt: z.ZodString;
+        status: z.ZodLiteral<"failed">;
+        completedAt: z.ZodString;
+        error: z.ZodObject<{
+            type: z.ZodString;
+            title: z.ZodString;
+            status: z.ZodNumber;
+            detail: z.ZodString;
+            code: z.ZodString;
+            pointer: z.ZodOptional<z.ZodString>;
+            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            next: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requestId: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        origin: z.ZodEnum<{
+            function: "function";
+            zero: "zero";
+            api: "api";
+            dashboard: "dashboard";
+            mcp: "mcp";
+            cli: "cli";
+            system: "system";
+        }>;
+        space: z.ZodNullable<z.ZodString>;
+        handler: z.ZodNullable<z.ZodString>;
+        visitor: z.ZodBoolean;
+        id: z.ZodString;
+        input: z.ZodObject<{
+            kind: z.ZodEnum<{
+                tool: "tool";
+                code: "code";
+            }>;
+            address: z.ZodNullable<z.ZodString>;
+            digest: z.ZodString;
+        }, z.core.$strip>;
+        usage: z.ZodObject<{
+            toolCalls: z.ZodNumber;
+            egressBytes: z.ZodNumber;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>;
+        createdAt: z.ZodString;
+        status: z.ZodLiteral<"expired">;
+        completedAt: z.ZodString;
+    }, z.core.$strip>], "status">>;
+}, z.core.$strip>;
+export type SuperadminTeamConnectors = z.infer<typeof SuperadminTeamConnectorsSchema>;

package/dist/contracts/superadmin-connectors.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { ConnectorRunSchema, ConnectorSchema, PolicyRuleSchema, runStatusSchema, connectorRunOriginSchema, } from "./connectors.js";
+import { connectorsServingSchema } from "./teams.js";
+/**
+ * The superadmin read of connector runs across every team: the inbox support
+ * opens when a customer reports a stuck or refused call. Reads only; a run is
+ * decided by the person policy named, never from here.
+ */
+export const superadminConnectorRunListQuerySchema = z.object({
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+    offset: z.coerce.number().int().min(0).default(0),
+    /** Matches a run id, a team id or slug, or part of an address. */
+    search: z.string().trim().optional(),
+    status: runStatusSchema.optional(),
+    teamId: z.string().trim().optional(),
+    origin: connectorRunOriginSchema.optional(),
+    space: z.string().trim().min(1).optional(),
+});
+export const SuperadminConnectorRunSchema = z.object({
+    origin: connectorRunOriginSchema,
+    space: z.string().nullable(),
+    handler: z.string().nullable(),
+    visitor: z.boolean(),
+    id: z.string(),
+    team: z.object({
+        id: z.string(),
+        name: z.string().nullable(),
+        slug: z.string().nullable(),
+    }),
+    kind: z.enum(["tool", "code"]),
+    address: z.string().nullable(),
+    status: runStatusSchema,
+    errorCode: z.string().nullable(),
+    actorUserId: z.string().nullable(),
+    credentialId: z.string().nullable(),
+    decisionId: z.string().nullable(),
+    approval: z
+        .object({
+        mode: z.enum(["model", "human"]),
+        address: z.string(),
+        reason: z.string(),
+        expiresAt: z.string().nullable(),
+    })
+        .nullable(),
+    toolCalls: z.number().int().nonnegative(),
+    egressBytes: z.number().int().nonnegative(),
+    durationMs: z.number().int().nonnegative().nullable(),
+    createdAt: z.string(),
+    completedAt: z.string().nullable(),
+});
+export const SuperadminTeamConnectorsSchema = z.object({
+    connectorsServing: connectorsServingSchema.default({ adminOnly: false, allowlist: null }),
+    team: z.object({ id: z.string(), name: z.string(), slug: z.string() }),
+    spaces: z.array(z.object({ id: z.string(), title: z.string() })),
+    visitorConnections: z
+        .array(z.object({ spaceId: z.string(), count: z.number().int().nonnegative() }))
+        .default([]),
+    connectors: z.array(ConnectorSchema),
+    policies: z.array(PolicyRuleSchema),
+    runs: z.array(ConnectorRunSchema),
+});

package/dist/contracts/superadmin-emails.d.ts

@@ -8,8 +8,8 @@ export declare const superadminEmailListQuerySchema: z.ZodObject<{
     status: z.ZodDefault<z.ZodEnum<{
         all: "all";
         failed: "failed";
-        scheduled: "scheduled";
         delivered: "delivered";
+        scheduled: "scheduled";
         sent: "sent";
         suppressed: "suppressed";
         bounced: "bounced";

package/dist/contracts/superadmin-emails.js

@@ -21,7 +21,7 @@ export const superadminEmailCategoryValues = emailCategoryValues;
 const bareEmailAddressSchema = z.string().email();
 const namedMailboxPattern = /^(?:"(?:[^"\\\r\n]|\\.)*"|[^<>\r\n]+)\s*<([^<>\r\n]+)>$/;
 // The stored sender is the provider-facing RFC mailbox header, not necessarily
-// a bare addr-spec. Resend accepts both `hello@example.com` and
+// a bare addr-spec. SES and Resend accept both `hello@example.com` and
 // `Spacefast <hello@example.com>`; the operator API must preserve that value.
 export const emailMailboxSchema = z
     .string()

package/dist/contracts/superadmin-entities.d.ts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+export declare const superadminEntityKindSchema: z.ZodEnum<{
+    build: "build";
+    email: "email";
+    space: "space";
+    team: "team";
+    version: "version";
+    tenant: "tenant";
+    operation: "operation";
+    user: "user";
+    externalPrincipal: "externalPrincipal";
+    providerSite: "providerSite";
+    providerClient: "providerClient";
+    betaInvite: "betaInvite";
+}>;
+export declare const SuperadminEntityIdentitySchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        build: "build";
+        email: "email";
+        space: "space";
+        team: "team";
+        version: "version";
+        tenant: "tenant";
+        operation: "operation";
+        user: "user";
+        externalPrincipal: "externalPrincipal";
+        providerSite: "providerSite";
+        providerClient: "providerClient";
+        betaInvite: "betaInvite";
+    }>;
+    id: z.ZodString;
+    label: z.ZodString;
+    secondary: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type SuperadminEntityKind = z.infer<typeof superadminEntityKindSchema>;
+export type SuperadminEntityIdentity = z.infer<typeof SuperadminEntityIdentitySchema>;
+export declare const SuperadminEntityIdentityRefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"externalPrincipal">;
+    id: z.ZodString;
+    tenantId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        build: "build";
+        email: "email";
+        space: "space";
+        team: "team";
+        version: "version";
+        tenant: "tenant";
+        operation: "operation";
+        user: "user";
+        providerSite: "providerSite";
+        providerClient: "providerClient";
+        betaInvite: "betaInvite";
+    }>;
+    id: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type SuperadminEntityIdentityRef = z.infer<typeof SuperadminEntityIdentityRefSchema>;
+export declare const SuperadminEntityIdentityBatchRequestSchema: z.ZodObject<{
+    refs: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"externalPrincipal">;
+        id: z.ZodString;
+        tenantId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodEnum<{
+            build: "build";
+            email: "email";
+            space: "space";
+            team: "team";
+            version: "version";
+            tenant: "tenant";
+            operation: "operation";
+            user: "user";
+            providerSite: "providerSite";
+            providerClient: "providerClient";
+            betaInvite: "betaInvite";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+export declare const SuperadminEntityIdentityBatchResponseSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    identities: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        $schema: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            build: "build";
+            email: "email";
+            space: "space";
+            team: "team";
+            version: "version";
+            tenant: "tenant";
+            operation: "operation";
+            user: "user";
+            externalPrincipal: "externalPrincipal";
+            providerSite: "providerSite";
+            providerClient: "providerClient";
+            betaInvite: "betaInvite";
+        }>;
+        id: z.ZodString;
+        label: z.ZodString;
+        secondary: z.ZodNullable<z.ZodString>;
+        status: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;

package/dist/contracts/superadmin-entities.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+export const superadminEntityKindSchema = z.enum([
+    "user",
+    "team",
+    "externalPrincipal",
+    "tenant",
+    "space",
+    "providerSite",
+    "providerClient",
+    "operation",
+    "build",
+    "version",
+    "betaInvite",
+    "email",
+]);
+export const SuperadminEntityIdentitySchema = z
+    .object({
+    $schema: z.string().url().optional(),
+    kind: superadminEntityKindSchema,
+    id: z.string(),
+    label: z.string().min(1),
+    secondary: z.string().min(1).nullable(),
+    status: z.string().min(1).nullable(),
+})
+    .strict();
+export const SuperadminEntityIdentityRefSchema = z.discriminatedUnion("kind", [
+    z
+        .object({
+        kind: z.literal("externalPrincipal"),
+        id: z.string().trim().min(1),
+        tenantId: z.string().trim().min(1),
+    })
+        .strict(),
+    z
+        .object({
+        kind: z.enum([
+            "user",
+            "team",
+            "tenant",
+            "space",
+            "providerSite",
+            "providerClient",
+            "operation",
+            "build",
+            "version",
+            "betaInvite",
+            "email",
+        ]),
+        id: z.string().trim().min(1),
+    })
+        .strict(),
+]);
+export const SuperadminEntityIdentityBatchRequestSchema = z
+    .object({
+    refs: z.array(SuperadminEntityIdentityRefSchema).min(1).max(100),
+})
+    .strict();
+export const SuperadminEntityIdentityBatchResponseSchema = z
+    .object({
+    $schema: z.string().url().optional(),
+    // Positional response: each item matches the request ref at the same index.
+    identities: z.array(SuperadminEntityIdentitySchema.nullable()),
+})
+    .strict();