@tarkahq/sdk 0.0.0-stage → 0.3.0

package/dist/cjs/generated/tarka/provisioning/v1/job.d.ts

@@ -0,0 +1,168 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "tarka.provisioning.v1";
+/** JobRunStatus describes a single immutable revision and its bounded attempts. */
+export declare enum JobRunStatus {
+    JOB_RUN_STATUS_UNSPECIFIED = 0,
+    JOB_RUN_STATUS_QUEUED = 1,
+    JOB_RUN_STATUS_PROVISIONING = 2,
+    JOB_RUN_STATUS_RUNNING = 3,
+    JOB_RUN_STATUS_STOPPING = 4,
+    JOB_RUN_STATUS_SUCCEEDED = 5,
+    JOB_RUN_STATUS_FAILED = 6,
+    JOB_RUN_STATUS_CANCELLED = 7,
+    JOB_RUN_STATUS_EXPIRED = 8,
+    UNRECOGNIZED = -1
+}
+export declare function jobRunStatusFromJSON(object: any): JobRunStatus;
+export declare function jobRunStatusToJSON(object: JobRunStatus): string;
+/**
+ * JobResources bounds a single execution attempt. Zero selects the documented
+ * default. The preview supports up to 6 vCPUs, 32 GiB RAM and 32 GiB scratch.
+ * Memory and scratch are independent; scratch is ephemeral and not a volume.
+ */
+export interface JobResources {
+    /** cpu_millis defaults to 1000; explicit values are 250..6000. */
+    cpuMillis: number;
+    /** memory_mib defaults to 1024; explicit values are 128..32768. */
+    memoryMib: number;
+    /** ephemeral_storage_mib defaults to 1024; explicit values are 512..32768. */
+    ephemeralStorageMib: number;
+}
+/**
+ * JobRetryPolicy is explicit consent to possible repeated external effects.
+ * Only qualified infrastructure interruptions can retry, after confirmed
+ * termination of the old attempt. Exit failures and timeouts are not retried.
+ * Queue redelivery and lease expiry alone never authorize another attempt.
+ */
+export interface JobRetryPolicy {
+    retryable: boolean;
+    /**
+     * max_attempts includes the first attempt. Zero selects one; 2..3 require
+     * retryable=true. Each attempt has its own execution timeout and usage.
+     */
+    maxAttempts: number;
+    /**
+     * allow_spot requires retryable=true and max_attempts>=2. Unqualified Spot
+     * capacity is rejected; this flag never silently weakens isolation.
+     */
+    allowSpot: boolean;
+}
+/** JobRun is execution metadata, not a queue message or a credential container. */
+export interface JobRun {
+    id: string;
+    jobId: string;
+    orgId: string;
+    revision: bigint;
+    status: JobRunStatus;
+    location: string;
+    /** image_digest is the immutable image selected at admission. */
+    imageDigest: string;
+    resources: JobResources | undefined;
+    retryPolicy: JobRetryPolicy | undefined;
+    /**
+     * attempt is zero before the first claim and increases only after old work
+     * has been confirmed stopped. At most one attempt may execute at a time.
+     */
+    attempt: number;
+    timeoutSeconds: number;
+    createdAt: Date | undefined;
+    queueDeadline: Date | undefined;
+    /** started_at is unset until execution actually starts; setup time is free. */
+    startedAt: Date | undefined;
+    finishedAt: Date | undefined;
+    /** failure_code is a stable bounded machine code, never customer logs. */
+    failureCode: string;
+    /** exit_code is present only when the runtime observed an exit status. */
+    exitCode?: number | undefined;
+}
+/** GetJobRequest selects a job visible to the organization member. */
+export interface GetJobRequest {
+    orgId: string;
+    jobId: string;
+}
+/** ListJobRunsRequest selects one organization's job, newest revision first. */
+export interface ListJobRunsRequest {
+    orgId: string;
+    jobId: string;
+    /** page_size defaults to 50 and is capped at 100. */
+    pageSize: number;
+    /**
+     * page_token is opaque, at most 1024 bytes, and bound to the same
+     * organization and job.
+     */
+    pageToken: string;
+}
+/** ListJobRunsResponse contains a bounded page of execution history. */
+export interface ListJobRunsResponse {
+    runs: JobRun[];
+    nextPageToken: string;
+}
+/** GetJobRunRequest selects an immutable run belonging to the specified job. */
+export interface GetJobRunRequest {
+    orgId: string;
+    jobId: string;
+    runId: string;
+}
+/** CancelJobRunRequest requires an organization owner, admin or operator. */
+export interface CancelJobRunRequest {
+    orgId: string;
+    jobId: string;
+    runId: string;
+}
+/**
+ * GetJobRunResultRequest requires the same organization/product access as the
+ * run. Nonterminal runs fail with FAILED_PRECONDITION; missing/expired logs do
+ * not erase terminal metadata and never expose another organization's object.
+ */
+export interface GetJobRunResultRequest {
+    orgId: string;
+    jobId: string;
+    runId: string;
+}
+/**
+ * JobRunResult retains terminal metadata after the logs' seven-day retention.
+ * Signed URLs are temporary bearer capabilities; clients must not publish them.
+ */
+export interface JobRunResult {
+    runId: string;
+    status: JobRunStatus;
+    exitCode?: number | undefined;
+    /**
+     * logs_url is an HTTPS download of bounded combined stdout/stderr. It is
+     * empty if logs are unavailable or have expired, and is valid for <=5 minutes.
+     */
+    logsUrl: string;
+    downloadExpiresAt: Date | undefined;
+    logsExpiresAt: Date | undefined;
+    logsTruncated: boolean;
+    logsBytes: bigint;
+}
+export declare const JobResources: MessageFns<JobResources>;
+export declare const JobRetryPolicy: MessageFns<JobRetryPolicy>;
+export declare const JobRun: MessageFns<JobRun>;
+export declare const GetJobRequest: MessageFns<GetJobRequest>;
+export declare const ListJobRunsRequest: MessageFns<ListJobRunsRequest>;
+export declare const ListJobRunsResponse: MessageFns<ListJobRunsResponse>;
+export declare const GetJobRunRequest: MessageFns<GetJobRunRequest>;
+export declare const CancelJobRunRequest: MessageFns<CancelJobRunRequest>;
+export declare const GetJobRunResultRequest: MessageFns<GetJobRunResultRequest>;
+export declare const JobRunResult: MessageFns<JobRunResult>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+export type DeepPartial<T> = T extends bigint ? string | number | bigint : T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    $case: string;
+    value: unknown;
+} ? {
+    $case: T["$case"];
+    value?: DeepPartial<T["value"]>;
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create(base?: DeepPartial<T>): T;
+    fromPartial(object: DeepPartial<T>): T;
+}
+export {};