@cyanautomation/kaseki-agent 1.4.1

package/dist/kaseki-api-types.d.ts

@@ -0,0 +1,440 @@
+import { z } from 'zod';
+/**
+ * Webhook event types.
+ */
+export declare enum WebhookEventType {
+    JOB_SUBMITTED = "job.submitted",
+    JOB_STARTED = "job.started",
+    JOB_PROGRESS = "job.progress",
+    JOB_COMPLETED = "job.completed",
+    JOB_FAILED = "job.failed",
+    JOB_CANCELLED = "job.cancelled"
+}
+/**
+ * Webhook configuration for a run.
+ */
+export declare const WebhookConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    secret: z.ZodOptional<z.ZodString>;
+    events: z.ZodOptional<z.ZodArray<z.ZodNativeEnum<typeof WebhookEventType>, "many">>;
+    retryPolicy: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodDefault<z.ZodNumber>;
+        initialDelayMs: z.ZodDefault<z.ZodNumber>;
+        maxDelayMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxAttempts: number;
+        initialDelayMs: number;
+        maxDelayMs: number;
+    }, {
+        maxAttempts?: number | undefined;
+        initialDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    secret?: string | undefined;
+    events?: WebhookEventType[] | undefined;
+    retryPolicy?: {
+        maxAttempts: number;
+        initialDelayMs: number;
+        maxDelayMs: number;
+    } | undefined;
+}, {
+    url: string;
+    secret?: string | undefined;
+    events?: WebhookEventType[] | undefined;
+    retryPolicy?: {
+        maxAttempts?: number | undefined;
+        initialDelayMs?: number | undefined;
+        maxDelayMs?: number | undefined;
+    } | undefined;
+}>;
+export type WebhookConfig = z.infer<typeof WebhookConfigSchema>;
+/**
+ * Webhook payload event.
+ */
+export interface WebhookPayload {
+    eventType: WebhookEventType;
+    jobId: string;
+    timestamp: string;
+    data: {
+        status?: 'queued' | 'running' | 'completed' | 'failed';
+        stage?: string;
+        elapsed?: number;
+        timeoutRiskPercent?: number;
+        exitCode?: number;
+        failureClass?: string;
+        error?: string;
+    };
+}
+/**
+ * Request tracing info.
+ */
+export declare const RequestTracingSchema: z.ZodObject<{
+    correlationId: z.ZodOptional<z.ZodString>;
+    requestId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    correlationId?: string | undefined;
+    requestId?: string | undefined;
+}, {
+    correlationId?: string | undefined;
+    requestId?: string | undefined;
+}>;
+export type RequestTracing = z.infer<typeof RequestTracingSchema>;
+/**
+ * Request to trigger a new kaseki run.
+ */
+export declare const RunRequestSchema: z.ZodObject<{
+    repoUrl: z.ZodString;
+    ref: z.ZodDefault<z.ZodString>;
+    taskPrompt: z.ZodOptional<z.ZodString>;
+    changedFilesAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    allowlist: z.ZodOptional<z.ZodObject<{
+        include: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        include?: string[] | undefined;
+    }, {
+        include?: string[] | undefined;
+    }>>;
+    maxDiffBytes: z.ZodOptional<z.ZodNumber>;
+    validationCommands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    validation: z.ZodOptional<z.ZodObject<{
+        commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        commands?: string[] | undefined;
+    }, {
+        commands?: string[] | undefined;
+    }>>;
+    taskMode: z.ZodOptional<z.ZodEnum<["patch", "inspect"]>>;
+    publishMode: z.ZodOptional<z.ZodEnum<["none", "branch", "draft_pr"]>>;
+    startupCheck: z.ZodOptional<z.ZodBoolean>;
+    webhookConfig: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        secret: z.ZodOptional<z.ZodString>;
+        events: z.ZodOptional<z.ZodArray<z.ZodNativeEnum<typeof WebhookEventType>, "many">>;
+        retryPolicy: z.ZodOptional<z.ZodObject<{
+            maxAttempts: z.ZodDefault<z.ZodNumber>;
+            initialDelayMs: z.ZodDefault<z.ZodNumber>;
+            maxDelayMs: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxAttempts: number;
+            initialDelayMs: number;
+            maxDelayMs: number;
+        }, {
+            maxAttempts?: number | undefined;
+            initialDelayMs?: number | undefined;
+            maxDelayMs?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        secret?: string | undefined;
+        events?: WebhookEventType[] | undefined;
+        retryPolicy?: {
+            maxAttempts: number;
+            initialDelayMs: number;
+            maxDelayMs: number;
+        } | undefined;
+    }, {
+        url: string;
+        secret?: string | undefined;
+        events?: WebhookEventType[] | undefined;
+        retryPolicy?: {
+            maxAttempts?: number | undefined;
+            initialDelayMs?: number | undefined;
+            maxDelayMs?: number | undefined;
+        } | undefined;
+    }>>;
+    tracing: z.ZodOptional<z.ZodObject<{
+        correlationId: z.ZodOptional<z.ZodString>;
+        requestId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        correlationId?: string | undefined;
+        requestId?: string | undefined;
+    }, {
+        correlationId?: string | undefined;
+        requestId?: string | undefined;
+    }>>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    timeoutSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    ref: string;
+    repoUrl: string;
+    validation?: {
+        commands?: string[] | undefined;
+    } | undefined;
+    allowlist?: {
+        include?: string[] | undefined;
+    } | undefined;
+    validationCommands?: string[] | undefined;
+    taskPrompt?: string | undefined;
+    changedFilesAllowlist?: string[] | undefined;
+    maxDiffBytes?: number | undefined;
+    taskMode?: "patch" | "inspect" | undefined;
+    publishMode?: "none" | "branch" | "draft_pr" | undefined;
+    startupCheck?: boolean | undefined;
+    webhookConfig?: {
+        url: string;
+        secret?: string | undefined;
+        events?: WebhookEventType[] | undefined;
+        retryPolicy?: {
+            maxAttempts: number;
+            initialDelayMs: number;
+            maxDelayMs: number;
+        } | undefined;
+    } | undefined;
+    tracing?: {
+        correlationId?: string | undefined;
+        requestId?: string | undefined;
+    } | undefined;
+    idempotencyKey?: string | undefined;
+    timeoutSeconds?: number | undefined;
+}, {
+    repoUrl: string;
+    validation?: {
+        commands?: string[] | undefined;
+    } | undefined;
+    ref?: string | undefined;
+    allowlist?: {
+        include?: string[] | undefined;
+    } | undefined;
+    validationCommands?: string[] | undefined;
+    taskPrompt?: string | undefined;
+    changedFilesAllowlist?: string[] | undefined;
+    maxDiffBytes?: number | undefined;
+    taskMode?: "patch" | "inspect" | undefined;
+    publishMode?: "none" | "branch" | "draft_pr" | undefined;
+    startupCheck?: boolean | undefined;
+    webhookConfig?: {
+        url: string;
+        secret?: string | undefined;
+        events?: WebhookEventType[] | undefined;
+        retryPolicy?: {
+            maxAttempts?: number | undefined;
+            initialDelayMs?: number | undefined;
+            maxDelayMs?: number | undefined;
+        } | undefined;
+    } | undefined;
+    tracing?: {
+        correlationId?: string | undefined;
+        requestId?: string | undefined;
+    } | undefined;
+    idempotencyKey?: string | undefined;
+    timeoutSeconds?: number | undefined;
+}>;
+export type RunRequest = z.infer<typeof RunRequestSchema>;
+/**
+ * Response after triggering a run.
+ */
+export interface RunResponse {
+    id: string;
+    status: 'queued' | 'running' | 'completed' | 'failed';
+    createdAt: string;
+    correlationId?: string;
+    requestId?: string;
+    cached?: boolean;
+    completedAt?: string;
+    exitCode?: number;
+    failureClass?: string;
+    error?: string;
+}
+/**
+ * Structured progress information for a run.
+ */
+export interface StructuredProgress {
+    stage: string;
+    percentComplete?: number;
+    message?: string;
+    updatedAt?: string;
+}
+/**
+ * Status poll response.
+ */
+export interface StatusResponse {
+    id: string;
+    status: 'queued' | 'running' | 'completed' | 'failed';
+    progress?: StructuredProgress;
+    elapsedSeconds?: number;
+    timeoutRiskPercent?: number;
+    exitCode?: number;
+    failureClass?: string;
+    validationFailureReason?: string;
+    qualityFailureReason?: string;
+    error?: string;
+    resultDir?: string;
+    correlationId?: string;
+    requestId?: string;
+    artifacts?: {
+        metadataJson: boolean;
+        analysisMd: boolean;
+        resultSummaryMd: boolean;
+        failureJson: boolean;
+        stderrLog: boolean;
+        availableFiles: string[];
+    };
+    diagnosticEntryPoint?: 'failure.json' | 'analysis.md' | 'result-summary.md';
+}
+/**
+ * Pre-flight validation check result.
+ */
+export interface ValidationCheck {
+    name: string;
+    status: 'pass' | 'fail' | 'warning';
+    message: string;
+    detail?: string;
+}
+/**
+ * Pre-flight validation response.
+ */
+export interface ValidationResponse {
+    isValid: boolean;
+    checks: ValidationCheck[];
+    warnings: string[];
+    errors: string[];
+    estimatedDurationSeconds?: number;
+}
+/**
+ * Log retrieval response.
+ */
+export interface LogResponse {
+    logType: 'stdout' | 'stderr' | 'validation' | 'progress' | 'quality' | 'secret-scan';
+    content: string;
+    size: number;
+}
+/**
+ * Artifact download response.
+ */
+export interface ArtifactResponse {
+    file: string;
+    contentType: string;
+    size: number;
+    content?: string;
+    url?: string;
+}
+export interface RunArtifactFileMetadata {
+    name: string;
+    size: number;
+    contentType: string;
+    available: boolean;
+}
+export interface RunArtifactsResponse {
+    id: string;
+    runStatus: 'queued' | 'running' | 'completed' | 'failed';
+    exitCode?: number;
+    artifacts: RunArtifactFileMetadata[];
+    recommended: string[];
+}
+/**
+ * Run analysis response (comprehensive summary).
+ */
+export interface AnalysisResponse {
+    id: string;
+    status: 'queued' | 'running' | 'completed' | 'failed';
+    createdAt: string;
+    completedAt?: string;
+    elapsedSeconds?: number;
+    exitCode?: number;
+    failureClass?: string;
+    metadata?: {
+        model?: string;
+        instance?: string;
+        repo?: string;
+        ref?: string;
+    };
+    changes?: {
+        changedFiles: string[];
+        diffSize: number;
+    };
+    validation?: {
+        passed: boolean;
+        commandResults: Array<{
+            command: string;
+            exitCode: number;
+            elapsed: number;
+        }>;
+    };
+    errors?: string[];
+}
+/**
+ * List runs response.
+ */
+export interface RunsListResponse {
+    runs: Array<{
+        id: string;
+        status: 'queued' | 'running' | 'completed' | 'failed';
+        createdAt: string;
+        completedAt?: string;
+        resultDir?: string;
+        exitCode?: number;
+        failureClass?: string;
+        error?: string;
+    }>;
+    total: number;
+    retention?: {
+        terminalJobIndexMaxEntries: number;
+        note: string;
+    };
+}
+export interface PreflightCheck {
+    name: string;
+    ok: boolean;
+    detail?: string;
+    remediation?: string;
+}
+export interface PreflightResponse {
+    status: 'ok' | 'degraded' | 'error';
+    timestamp: string;
+    checks: PreflightCheck[];
+    image?: string;
+    imageDigest?: string;
+    templateImage?: string;
+    templateImageDigest?: string;
+    templateDir?: string;
+    templateRef?: string;
+    resultsDir: string;
+    runtime?: {
+        nodeVersion: string;
+        uid?: number;
+        gid?: number;
+        groups?: number[];
+    };
+    docker?: {
+        version?: string;
+        clientVersion?: string;
+        serverVersion?: string;
+    };
+}
+/**
+ * Error response (RFC 7807 Problem Details).
+ */
+export interface ErrorResponse {
+    type: string;
+    title: string;
+    status: number;
+    detail: string;
+    instance?: string;
+}
+/**
+ * Internal job representation.
+ */
+export interface Job {
+    id: string;
+    status: 'queued' | 'running' | 'completed' | 'failed';
+    request: RunRequest;
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    exitCode?: number;
+    failureClass?: string;
+    error?: string;
+    resultDir?: string;
+    processId?: number;
+    timeout?: NodeJS.Timeout;
+    finalized?: boolean;
+    webhookConfig?: WebhookConfig;
+    correlationId?: string;
+    requestId?: string;
+    currentStage?: string;
+    idempotencyKey?: string;
+    effectiveTimeoutSeconds?: number;
+}
+//# sourceMappingURL=kaseki-api-types.d.ts.map

package/dist/kaseki-api-types.d.ts.map

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

package/dist/kaseki-api-types.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+/**
+ * Webhook event types.
+ */
+export var WebhookEventType;
+(function (WebhookEventType) {
+    WebhookEventType["JOB_SUBMITTED"] = "job.submitted";
+    WebhookEventType["JOB_STARTED"] = "job.started";
+    WebhookEventType["JOB_PROGRESS"] = "job.progress";
+    WebhookEventType["JOB_COMPLETED"] = "job.completed";
+    WebhookEventType["JOB_FAILED"] = "job.failed";
+    WebhookEventType["JOB_CANCELLED"] = "job.cancelled";
+})(WebhookEventType || (WebhookEventType = {}));
+/**
+ * Webhook configuration for a run.
+ */
+export const WebhookConfigSchema = z.object({
+    url: z.string().url('Webhook URL must be valid'),
+    secret: z.string().min(16).optional().describe('HMAC secret for signature verification'),
+    events: z.array(z.nativeEnum(WebhookEventType)).optional().describe('Event types to deliver'),
+    retryPolicy: z.object({
+        maxAttempts: z.number().int().min(1).max(10).default(5),
+        initialDelayMs: z.number().int().min(100).max(5000).default(1000),
+        maxDelayMs: z.number().int().min(1000).max(60000).default(30000),
+    }).optional(),
+});
+/**
+ * Request tracing info.
+ */
+export const RequestTracingSchema = z.object({
+    correlationId: z.string().uuid().optional().describe('Correlation ID for tracking'),
+    requestId: z.string().uuid().optional().describe('Unique request ID'),
+});
+/**
+ * Request to trigger a new kaseki run.
+ */
+export const RunRequestSchema = z.object({
+    repoUrl: z.string().url('Repository URL must be valid').describe('Git repository URL'),
+    ref: z.string().min(1).default('main').describe('Git branch/tag/commit'),
+    taskPrompt: z.string().min(10).optional().describe('Task prompt for Pi agent'),
+    changedFilesAllowlist: z.array(z.string()).optional().describe('Space-separated file patterns'),
+    allowlist: z
+        .object({
+        include: z.array(z.string()).optional().describe('Alias for changedFilesAllowlist'),
+    })
+        .optional()
+        .describe('Controller-friendly allowlist alias'),
+    maxDiffBytes: z.number().int().positive().optional().describe('Max diff size in bytes'),
+    validationCommands: z.array(z.string()).optional().describe('Validation commands to run'),
+    validation: z
+        .object({
+        commands: z.array(z.string()).optional().describe('Alias for validationCommands'),
+    })
+        .optional()
+        .describe('Controller-friendly validation alias'),
+    taskMode: z.enum(['patch', 'inspect']).optional().describe('Task mode: patch or inspect'),
+    publishMode: z.enum(['none', 'branch', 'draft_pr']).optional().describe('Publishing mode after validation'),
+    startupCheck: z.boolean().optional().describe('Start a worker container and exit after boot/runtime checks'),
+    webhookConfig: WebhookConfigSchema.optional().describe('Webhook configuration for job events'),
+    tracing: RequestTracingSchema.optional().describe('Request tracing identifiers'),
+    idempotencyKey: z.string().uuid().optional().describe('Idempotency key for safe retries'),
+    timeoutSeconds: z.number().int().min(60).max(10800).optional().describe('Per-run timeout in seconds'),
+});
+//# sourceMappingURL=kaseki-api-types.js.map

package/dist/kaseki-api-types.js.map

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