@polpo-ai/core 0.15.44 → 0.15.46

package/dist/scheduling/types.d.ts

@@ -0,0 +1,195 @@
+export type ScheduleJsonPrimitive = string | number | boolean | null;
+export type ScheduleJsonValue = ScheduleJsonPrimitive | ScheduleJsonValue[] | {
+    [key: string]: ScheduleJsonValue;
+};
+export type ScheduleMetadata = Record<string, ScheduleJsonValue>;
+export type ScheduleStatus = "active" | "paused" | "completed" | "deleted";
+export type ScheduleCatchUpPolicy = "skip" | "latest";
+export interface ScheduleCronTiming {
+    kind: "cron";
+    expression: string;
+    timezone: string;
+}
+export interface ScheduleOnceTiming {
+    kind: "once";
+    /** Absolute ISO 8601 timestamp. */
+    at: string;
+    /** IANA timezone used for presentation and future calendar operations. */
+    timezone: string;
+}
+export type ScheduleTiming = ScheduleCronTiming | ScheduleOnceTiming;
+export interface ScheduleMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface ScheduleExecutionOptions {
+    loop?: string;
+    model?: string;
+    sandbox?: {
+        isolation?: "reuse" | "fresh";
+    };
+    guardrails?: {
+        mode?: string;
+    };
+    metadata?: ScheduleMetadata;
+}
+export interface ScheduleAgentInvocation {
+    surface: "agent";
+    agentName: string;
+    input: {
+        prompt?: string;
+        messages?: ScheduleMessage[];
+    };
+    session?: {
+        mode: "new" | "reuse";
+        sessionId?: string;
+        userId?: string;
+    };
+    execution?: ScheduleExecutionOptions;
+}
+export interface ScheduleTaskInvocation {
+    surface: "task";
+    agentName: string;
+    title: string;
+    prompt: string;
+    userId?: string;
+    metadata?: ScheduleMetadata;
+    execution?: ScheduleExecutionOptions;
+}
+export interface ScheduleChannelSendInvocation {
+    surface: "channel";
+    channelId: string;
+    routeId?: string;
+    externalThreadId?: string;
+    mode: "send";
+    text: string;
+    metadata?: ScheduleMetadata;
+}
+export interface ScheduleChannelAgentReplyInvocation {
+    surface: "channel";
+    channelId: string;
+    routeId?: string;
+    externalThreadId?: string;
+    mode: "agent_reply";
+    agentName: string;
+    prompt: string;
+    metadata?: ScheduleMetadata;
+    execution?: ScheduleExecutionOptions;
+}
+export type ScheduleChannelInvocation = ScheduleChannelSendInvocation | ScheduleChannelAgentReplyInvocation;
+export interface ScheduleWebhookInvocation {
+    surface: "webhook";
+    webhookId: string;
+    payload?: ScheduleMetadata;
+}
+export interface ScheduleLegacyMissionInvocation {
+    surface: "legacy_mission";
+    missionId: string;
+}
+export type ScheduleInvocation = ScheduleAgentInvocation | ScheduleTaskInvocation | ScheduleChannelInvocation | ScheduleWebhookInvocation | ScheduleLegacyMissionInvocation;
+export interface SchedulePolicy {
+    catchUp: ScheduleCatchUpPolicy;
+    misfireGraceSeconds: number;
+    maxConcurrency: number;
+}
+export interface ScheduleDriverRegistration {
+    kind: string;
+    status: "pending" | "registered" | "failed" | "not_required";
+    providerId?: string;
+    metadata?: ScheduleMetadata;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    updatedAt: string;
+}
+export interface Schedule {
+    id: string;
+    name?: string;
+    description?: string;
+    timing: ScheduleTiming;
+    invocation: ScheduleInvocation;
+    status: ScheduleStatus;
+    policy: SchedulePolicy;
+    metadata: ScheduleMetadata;
+    nextOccurrenceAt?: string;
+    lastOccurrenceAt?: string;
+    driver?: ScheduleDriverRegistration;
+    createdAt: string;
+    updatedAt: string;
+    revision: number;
+}
+export interface CreateScheduleInput {
+    id?: string;
+    name?: string;
+    description?: string;
+    timing: ScheduleTiming;
+    invocation: ScheduleInvocation;
+    status?: Extract<ScheduleStatus, "active" | "paused">;
+    policy?: Partial<SchedulePolicy>;
+    metadata?: ScheduleMetadata;
+}
+export interface NormalizedCreateScheduleInput {
+    id?: string;
+    name?: string;
+    description?: string;
+    timing: ScheduleTiming;
+    invocation: ScheduleInvocation;
+    status: Extract<ScheduleStatus, "active" | "paused">;
+    policy: SchedulePolicy;
+    metadata: ScheduleMetadata;
+}
+export interface UpdateScheduleInput {
+    name?: string | null;
+    description?: string | null;
+    timing?: ScheduleTiming;
+    invocation?: ScheduleInvocation;
+    status?: Extract<ScheduleStatus, "active" | "paused" | "completed">;
+    policy?: Partial<SchedulePolicy>;
+    metadata?: ScheduleMetadata;
+}
+export interface LegacyMissionScheduleInput {
+    missionId: string;
+    expression: string;
+    recurring?: boolean;
+    endDate?: string;
+}
+export type ScheduleRunStatus = "pending" | "claimed" | "running" | "succeeded" | "failed" | "skipped" | "cancelled";
+export interface ScheduleLease {
+    owner: string;
+    token: string;
+    expiresAt: string;
+}
+export interface ScheduleRunReferences {
+    runtimeId?: string;
+    taskId?: string;
+    loopRunId?: string;
+    sessionId?: string;
+    channelEventId?: string;
+    providerDeliveryId?: string;
+}
+export interface ScheduleRunError {
+    code: string;
+    message: string;
+    retryable: boolean;
+    metadata?: ScheduleMetadata;
+}
+export interface ScheduleRun {
+    id: string;
+    scheduleId: string;
+    occurrenceAt: string;
+    triggerId: string;
+    idempotencyKey: string;
+    status: ScheduleRunStatus;
+    attempts: number;
+    lease?: ScheduleLease;
+    references: ScheduleRunReferences;
+    result?: ScheduleMetadata;
+    error?: ScheduleRunError;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scheduling/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scheduling/types.ts"],"names":[],"mappings":"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"}

package/dist/scheduling/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scheduling/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scheduling/types.ts"],"names":[],"mappings":""}

package/dist/scheduling/validation.d.ts

@@ -0,0 +1,28 @@
+import type { NormalizedCreateScheduleInput, ScheduleInvocation, ScheduleMetadata, ScheduleTiming, UpdateScheduleInput } from "./types.js";
+export declare const SCHEDULE_LIMITS: Readonly<{
+    idLength: 256;
+    nameLength: 200;
+    descriptionLength: 2000;
+    promptLength: 128000;
+    messageCount: 100;
+    metadataBytes: 16384;
+    metadataDepth: 12;
+    metadataNodes: 1000;
+    maxConcurrency: 100;
+    maxMisfireGraceSeconds: number;
+}>;
+export interface NormalizeScheduleOptions {
+    now?: Date | string;
+    allowPastOnce?: boolean;
+}
+export interface TranslateLegacyScheduleOptions extends NormalizeScheduleOptions {
+    timezone?: string;
+}
+export declare function normalizeCronExpression(value: unknown): string;
+export declare function normalizeScheduleTiming(value: unknown, options?: NormalizeScheduleOptions): ScheduleTiming;
+export declare function normalizeScheduleInvocation(value: unknown): ScheduleInvocation;
+export declare function normalizeCreateScheduleInput(value: unknown, options?: NormalizeScheduleOptions): NormalizedCreateScheduleInput;
+export declare function normalizeUpdateScheduleInput(value: unknown, options?: NormalizeScheduleOptions): UpdateScheduleInput;
+export declare function translateLegacyMissionSchedule(value: unknown, options?: TranslateLegacyScheduleOptions): NormalizedCreateScheduleInput;
+export declare function normalizeScheduleMetadata(value: unknown, label?: string): ScheduleMetadata;
+//# sourceMappingURL=validation.d.ts.map

package/dist/scheduling/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/scheduling/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,6BAA6B,EAG7B,kBAAkB,EAGlB,gBAAgB,EAEhB,cAAc,EACd,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;;;;;;EAW1B,CAAC;AAqBH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAc9D;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,cAAc,CA4BhB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAmB9E;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,6BAA6B,CAoC/B;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,wBAA6B,GACrC,mBAAmB,CAqDrB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,8BAAmC,GAC3C,6BAA6B,CA4E/B;AA4aD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,KAAK,SAAsB,GAC1B,gBAAgB,CAElB"}