@sentry/junior-plugin-api 0.198.0 → 0.199.0

package/dist/schemas.d.ts

@@ -1,261 +0,0 @@
-import { z } from "zod";
-/** Exact non-blank actor user id that rejects the sentinel "unknown". */
-export declare const actorUserIdSchema: z.ZodString;
-export declare const nonBlankStringSchema: z.ZodString;
-/** Complete Slack Location associated with a Conversation. */
-export declare const slackLocationSchema: z.ZodObject<{
-    id: z.ZodString;
-    provider: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    channelId: z.ZodString;
-    threadTs: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-/** Complete Location types supported by Junior. */
-export declare const locationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    id: z.ZodString;
-    provider: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    channelId: z.ZodString;
-    threadTs: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>], "provider">;
-/** Runtime platform names supported by plugin public contracts. */
-export declare const platformSchema: z.ZodEnum<{
-    slack: "slack";
-    local: "local";
-}>;
-/** Runtime source visibility visible to plugins. */
-export declare const sourceVisibilitySchema: z.ZodEnum<{
-    public: "public";
-    private: "private";
-}>;
-/** Provider-neutral visibility of a routed destination. */
-export declare const destinationVisibilitySchema: z.ZodEnum<{
-    public: "public";
-    private: "private";
-}>;
-/** Runtime-owned Slack address for routing future work or side effects. */
-export declare const slackDestinationSchema: z.ZodObject<{
-    platform: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    channelId: z.ZodString;
-}, z.core.$strict>;
-/** Runtime-owned local CLI conversation address. */
-export declare const localDestinationSchema: z.ZodObject<{
-    platform: z.ZodLiteral<"local">;
-    conversationId: z.ZodString;
-}, z.core.$strict>;
-/** Runtime-owned provider-neutral address for routing future work or side effects. */
-export declare const destinationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    platform: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    channelId: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    platform: z.ZodLiteral<"local">;
-    conversationId: z.ZodString;
-}, z.core.$strict>], "platform">;
-/** Runtime-owned Slack input Source. */
-export declare const slackSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    channelId: z.ZodString;
-    visibility: z.ZodEnum<{
-        public: "public";
-        private: "private";
-    }>;
-    messageTs: z.ZodOptional<z.ZodString>;
-    threadTs: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-/** Runtime-owned local CLI input Source. */
-export declare const localSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"local">;
-    visibility: z.ZodLiteral<"private">;
-    conversationId: z.ZodString;
-}, z.core.$strict>;
-/** Runtime-owned dashboard input Source. */
-export declare const webSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"web">;
-    visibility: z.ZodEnum<{
-        public: "public";
-        private: "private";
-    }>;
-    conversationId: z.ZodString;
-}, z.core.$strict>;
-/** Runtime-owned Resource event input Source. */
-export declare const resourceEventSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"resource_event">;
-    eventKey: z.ZodString;
-    eventType: z.ZodString;
-    identifier: z.ZodString;
-    namespace: z.ZodString;
-}, z.core.$strict>;
-/** Runtime-owned Scheduled task input Source. */
-export declare const scheduledTaskSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"scheduled_task">;
-}, z.core.$strict>;
-/** Runtime-owned Event task input Source. */
-export declare const eventTaskSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"event_task">;
-}, z.core.$strict>;
-/** Runtime-owned Plugin dispatch input Source. */
-export declare const pluginDispatchSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"plugin_dispatch">;
-}, z.core.$strict>;
-/** Runtime-owned Agent invocation input Source. */
-export declare const agentInvocationSourceSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"agent_invocation">;
-}, z.core.$strict>;
-/** Runtime-owned input Source. Stored `platform` and Location fields normalize on read. */
-export declare const sourceSchema: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    channelId: z.ZodString;
-    visibility: z.ZodEnum<{
-        public: "public";
-        private: "private";
-    }>;
-    messageTs: z.ZodOptional<z.ZodString>;
-    threadTs: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"local">;
-    visibility: z.ZodLiteral<"private">;
-    conversationId: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"web">;
-    visibility: z.ZodEnum<{
-        public: "public";
-        private: "private";
-    }>;
-    conversationId: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"resource_event">;
-    eventKey: z.ZodString;
-    eventType: z.ZodString;
-    identifier: z.ZodString;
-    namespace: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"scheduled_task">;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"event_task">;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"plugin_dispatch">;
-}, z.core.$strict>, z.ZodObject<{
-    kind: z.ZodLiteral<"agent_invocation">;
-}, z.core.$strict>], "kind">, unknown>;
-/** Stable user credential subject shape accepted from plugins. */
-export declare const pluginCredentialSubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"user">;
-    userId: z.ZodString;
-    allowedWhen: z.ZodLiteral<"private-direct-conversation">;
-}, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"user">;
-    userId: z.ZodString;
-    allowedWhen: z.ZodLiteral<"scheduled-task">;
-    taskId: z.ZodString;
-}, z.core.$strict>], "allowedWhen">;
-export declare const slackActorSchema: z.ZodObject<{
-    platform: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    email: z.ZodOptional<z.ZodString>;
-    fullName: z.ZodOptional<z.ZodString>;
-    userId: z.ZodString;
-    userName: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const localActorSchema: z.ZodObject<{
-    platform: z.ZodLiteral<"local">;
-    email: z.ZodOptional<z.ZodString>;
-    fullName: z.ZodOptional<z.ZodString>;
-    userId: z.ZodString;
-    userName: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const webActorSchema: z.ZodObject<{
-    platform: z.ZodLiteral<"web">;
-    email: z.ZodOptional<z.ZodString>;
-    fullName: z.ZodOptional<z.ZodString>;
-    userId: z.ZodString;
-    userName: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const systemActorSchema: z.ZodObject<{
-    platform: z.ZodLiteral<"system">;
-    name: z.ZodString;
-}, z.core.$strict>;
-/** Runtime-provided actor identity visible to plugin hooks. */
-export declare const actorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    platform: z.ZodLiteral<"slack">;
-    teamId: z.ZodString;
-    email: z.ZodOptional<z.ZodString>;
-    fullName: z.ZodOptional<z.ZodString>;
-    userId: z.ZodString;
-    userName: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>, z.ZodObject<{
-    platform: z.ZodLiteral<"local">;
-    email: z.ZodOptional<z.ZodString>;
-    fullName: z.ZodOptional<z.ZodString>;
-    userId: z.ZodString;
-    userName: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>, z.ZodObject<{
-    platform: z.ZodLiteral<"web">;
-    email: z.ZodOptional<z.ZodString>;
-    fullName: z.ZodOptional<z.ZodString>;
-    userId: z.ZodString;
-    userName: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>, z.ZodObject<{
-    platform: z.ZodLiteral<"system">;
-    name: z.ZodString;
-}, z.core.$strict>], "platform">;
-/** Core-owned provider account linked to a user when verified. */
-export declare const identitySchema: z.ZodObject<{
-    displayName: z.ZodOptional<z.ZodString>;
-    handle: z.ZodOptional<z.ZodString>;
-    id: z.ZodString;
-    provider: z.ZodString;
-    providerSubjectId: z.ZodString;
-    providerTenantId: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-/** Core-owned person with every linked provider identity. */
-export declare const userSchema: z.ZodObject<{
-    displayName: z.ZodOptional<z.ZodString>;
-    email: z.ZodString;
-    id: z.ZodString;
-    identities: z.ZodArray<z.ZodObject<{
-        displayName: z.ZodOptional<z.ZodString>;
-        handle: z.ZodOptional<z.ZodString>;
-        id: z.ZodString;
-        provider: z.ZodString;
-        providerSubjectId: z.ZodString;
-        providerTenantId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-/** Compact destination-visible context explaining what produced a reply. */
-export declare const replyAttributionSchema: z.ZodObject<{
-    label: z.ZodPipe<z.ZodString, z.ZodString>;
-    detail: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodString>>;
-}, z.core.$strict>;
-/** Plugin dispatch request accepted by Junior core. */
-export declare const dispatchOptionsSchema: z.ZodObject<{
-    idempotencyKey: z.ZodPipe<z.ZodString, z.ZodString>;
-    credentialSubject: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        type: z.ZodLiteral<"user">;
-        userId: z.ZodString;
-        allowedWhen: z.ZodLiteral<"private-direct-conversation">;
-    }, z.core.$strict>, z.ZodObject<{
-        type: z.ZodLiteral<"user">;
-        userId: z.ZodString;
-        allowedWhen: z.ZodLiteral<"scheduled-task">;
-        taskId: z.ZodString;
-    }, z.core.$strict>], "allowedWhen">>;
-    destination: z.ZodObject<{
-        platform: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        channelId: z.ZodString;
-    }, z.core.$strict>;
-    destinationVisibility: z.ZodEnum<{
-        public: "public";
-        private: "private";
-    }>;
-    input: z.ZodPipe<z.ZodString, z.ZodString>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    replyAttribution: z.ZodOptional<z.ZodObject<{
-        label: z.ZodPipe<z.ZodString, z.ZodString>;
-        detail: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodString>>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;

package/dist/state.d.ts

@@ -1,10 +0,0 @@
-export interface PluginState {
-    delete(key: string): Promise<void>;
-    get<T = unknown>(key: string): Promise<T | undefined>;
-    set(key: string, value: unknown, ttlMs?: number): Promise<void>;
-    setIfNotExists(key: string, value: unknown, ttlMs?: number): Promise<boolean>;
-    withLock<T>(key: string, ttlMs: number, callback: () => Promise<T>): Promise<T>;
-}
-export interface PluginReadState {
-    get<T = unknown>(key: string): Promise<T | undefined>;
-}

package/dist/tasks.d.ts

@@ -1,250 +0,0 @@
-/**
- * Public plugin background-task contracts.
- *
- * Plugins register small task handlers. Junior core owns scheduling, delivery,
- * retries, and the bounded run projection.
- */
-import { z } from "zod";
-import type { PluginConversationEvents } from "./conversation-events";
-import type { PluginContext, PluginEmbedder, PluginModel } from "./context";
-import type { PluginState } from "./state";
-/**
- * Runtime-owned provenance for a transcript message: whether it is a durable
- * instruction or ambient context, plus the actor identity when known. Missing
- * provenance on an entry means unattributed context.
- */
-export declare const pluginRunTranscriptProvenanceSchema: z.ZodObject<{
-    authority: z.ZodEnum<{
-        instruction: "instruction";
-        context: "context";
-    }>;
-    actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        platform: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"local">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"web">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"system">;
-        name: z.ZodString;
-    }, z.core.$strict>], "platform">>;
-}, z.core.$strict>;
-/** One normalized transcript entry from the completed run exposed to plugin tasks. */
-export declare const pluginRunTranscriptEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"message">;
-    role: z.ZodEnum<{
-        user: "user";
-        assistant: "assistant";
-    }>;
-    text: z.ZodString;
-    provenance: z.ZodOptional<z.ZodObject<{
-        authority: z.ZodEnum<{
-            instruction: "instruction";
-            context: "context";
-        }>;
-        actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            platform: z.ZodLiteral<"slack">;
-            teamId: z.ZodString;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"local">;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"web">;
-            email: z.ZodOptional<z.ZodString>;
-            fullName: z.ZodOptional<z.ZodString>;
-            userId: z.ZodString;
-            userName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>, z.ZodObject<{
-            platform: z.ZodLiteral<"system">;
-            name: z.ZodString;
-        }, z.core.$strict>], "platform">>;
-    }, z.core.$strict>>;
-    isRunActor: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>, z.ZodObject<{
-    type: z.ZodLiteral<"toolResult">;
-    toolName: z.ZodString;
-    isError: z.ZodBoolean;
-    text: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>], "type">;
-export type PluginRunTranscriptProvenance = z.output<typeof pluginRunTranscriptProvenanceSchema>;
-/** Runtime-owned completed-run projection exposed to plugin tasks. */
-export declare const pluginRunContextSchema: z.ZodObject<{
-    actorUserId: z.ZodOptional<z.ZodString>;
-    completedAtMs: z.ZodNumber;
-    conversationId: z.ZodString;
-    destination: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        platform: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        channelId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"local">;
-        conversationId: z.ZodString;
-    }, z.core.$strict>], "platform">;
-    locationId: z.ZodOptional<z.ZodString>;
-    actors: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        platform: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"local">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"web">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"system">;
-        name: z.ZodString;
-    }, z.core.$strict>], "platform">>;
-    actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        platform: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"local">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"web">;
-        email: z.ZodOptional<z.ZodString>;
-        fullName: z.ZodOptional<z.ZodString>;
-        userId: z.ZodString;
-        userName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        platform: z.ZodLiteral<"system">;
-        name: z.ZodString;
-    }, z.core.$strict>], "platform">>;
-    runId: z.ZodString;
-    source: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"slack">;
-        teamId: z.ZodString;
-        channelId: z.ZodString;
-        visibility: z.ZodEnum<{
-            public: "public";
-            private: "private";
-        }>;
-        messageTs: z.ZodOptional<z.ZodString>;
-        threadTs: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"local">;
-        visibility: z.ZodLiteral<"private">;
-        conversationId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"web">;
-        visibility: z.ZodEnum<{
-            public: "public";
-            private: "private";
-        }>;
-        conversationId: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"resource_event">;
-        eventKey: z.ZodString;
-        eventType: z.ZodString;
-        identifier: z.ZodString;
-        namespace: z.ZodString;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"scheduled_task">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"event_task">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"plugin_dispatch">;
-    }, z.core.$strict>, z.ZodObject<{
-        kind: z.ZodLiteral<"agent_invocation">;
-    }, z.core.$strict>], "kind">, unknown>;
-    transcript: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        type: z.ZodLiteral<"message">;
-        role: z.ZodEnum<{
-            user: "user";
-            assistant: "assistant";
-        }>;
-        text: z.ZodString;
-        provenance: z.ZodOptional<z.ZodObject<{
-            authority: z.ZodEnum<{
-                instruction: "instruction";
-                context: "context";
-            }>;
-            actor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                platform: z.ZodLiteral<"slack">;
-                teamId: z.ZodString;
-                email: z.ZodOptional<z.ZodString>;
-                fullName: z.ZodOptional<z.ZodString>;
-                userId: z.ZodString;
-                userName: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>, z.ZodObject<{
-                platform: z.ZodLiteral<"local">;
-                email: z.ZodOptional<z.ZodString>;
-                fullName: z.ZodOptional<z.ZodString>;
-                userId: z.ZodString;
-                userName: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>, z.ZodObject<{
-                platform: z.ZodLiteral<"web">;
-                email: z.ZodOptional<z.ZodString>;
-                fullName: z.ZodOptional<z.ZodString>;
-                userId: z.ZodString;
-                userName: z.ZodOptional<z.ZodString>;
-            }, z.core.$strict>, z.ZodObject<{
-                platform: z.ZodLiteral<"system">;
-                name: z.ZodString;
-            }, z.core.$strict>], "platform">>;
-        }, z.core.$strict>>;
-        isRunActor: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strict>, z.ZodObject<{
-        type: z.ZodLiteral<"toolResult">;
-        toolName: z.ZodString;
-        isError: z.ZodBoolean;
-        text: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>], "type">>;
-}, z.core.$strict>;
-export type PluginRunTranscriptEntry = z.output<typeof pluginRunTranscriptEntrySchema>;
-export type PluginRunContext = z.output<typeof pluginRunContextSchema>;
-/** Runtime context passed to a plugin-owned background task. */
-export interface PluginTaskContext extends PluginContext {
-    embedder: PluginEmbedder;
-    events: PluginConversationEvents;
-    id: string;
-    model: PluginModel;
-    name: string;
-    run: {
-        load(): Promise<PluginRunContext>;
-    };
-    state: PluginState;
-}
-/** Plugin task handler registered by name in a plugin manifest module. */
-export interface PluginTaskDefinition {
-    run(ctx: PluginTaskContext): Promise<void> | void;
-}
-/** Task handlers keyed by the plugin-owned task name. */
-export type PluginTasks = Record<string, PluginTaskDefinition>;