@mcoda/shared 0.1.76 → 0.1.78

package/dist/mswarm/GenericJobContract.d.ts

@@ -0,0 +1,136 @@
+export declare const MSWARM_GENERIC_JOB_SCHEMA_VERSION: "2026-06-14";
+export declare const MSWARM_GENERIC_JOB_SCHEMA_VERSIONS: readonly ["2026-06-14"];
+export type MswarmJobSchemaVersion = (typeof MSWARM_GENERIC_JOB_SCHEMA_VERSIONS)[number];
+export declare const MSWARM_KNOWN_JOB_TYPES: readonly ["render.blender", "cuda.run", "ffmpeg.cuda", "python.gpu", "package.job"];
+export type MswarmKnownJobType = (typeof MSWARM_KNOWN_JOB_TYPES)[number];
+export type MswarmRegisteredJobType = `tenant.${string}` | `package.${string}`;
+export type MswarmJobType = MswarmKnownJobType | MswarmRegisteredJobType;
+export declare const MSWARM_JOB_STATUSES: readonly ["queued", "running", "succeeded", "failed", "cancelled", "expired"];
+export type MswarmJobStatus = (typeof MSWARM_JOB_STATUSES)[number];
+export declare const MSWARM_JOB_EVENT_TYPES: readonly ["queued", "scheduled", "started", "heartbeat", "stdout", "stderr", "log_truncated", "progress", "metric", "artifact", "completed", "failed", "cancelled"];
+export type MswarmJobEventType = (typeof MSWARM_JOB_EVENT_TYPES)[number];
+export declare const MSWARM_JOB_TRUST_MODES: readonly ["owner-local", "tenant-owned"];
+export type MswarmJobTrustMode = (typeof MSWARM_JOB_TRUST_MODES)[number];
+export declare const MSWARM_JOB_NETWORK_POLICIES: readonly ["none", "egress-allowlist"];
+export type MswarmJobNetworkPolicy = (typeof MSWARM_JOB_NETWORK_POLICIES)[number];
+export type MswarmGpuVendor = "nvidia" | "amd" | "apple" | (string & {});
+export declare const MSWARM_ARTIFACT_SCOPES: readonly ["input", "output", "log", "manifest"];
+export type MswarmArtifactScope = (typeof MSWARM_ARTIFACT_SCOPES)[number];
+export type MswarmGenericJobErrorCode = "invalid_request" | "invalid_schema_version" | "invalid_job_type" | "unregistered_job_type" | "invalid_registered_job_catalog" | "invalid_policy" | "invalid_limits" | "invalid_resources" | "invalid_artifact" | "invalid_output" | "invalid_args" | "unknown_field" | "llm_field_not_allowed" | "unsafe_field" | "unsafe_artifact_uri" | "unsafe_path";
+export interface MswarmGenericJobValidationIssue {
+    code: MswarmGenericJobErrorCode;
+    path: string;
+    message: string;
+    value?: unknown;
+}
+export interface MswarmRegisteredJobCatalogEntry {
+    job_type: MswarmRegisteredJobType;
+    args_schema: Record<string, unknown>;
+    policy: MswarmJobPolicy;
+    runner: string;
+}
+export interface MswarmJobPolicy {
+    trust_mode: MswarmJobTrustMode;
+    network?: MswarmJobNetworkPolicy;
+    allow_raw_command?: false;
+    allowed_images?: string[];
+    allowed_package_publishers?: string[];
+    max_artifact_bytes?: number;
+}
+export interface MswarmResourceRequest {
+    gpu?: {
+        count?: number;
+        min_vram_gb?: number;
+        vendor?: MswarmGpuVendor;
+        cuda_min_version?: string;
+        capabilities?: string[];
+    };
+    cpu?: {
+        cores?: number;
+    };
+    memory_gb?: number;
+    disk_gb?: number;
+}
+export interface MswarmJobLimits {
+    timeout_sec?: number;
+    max_stdout_bytes?: number;
+    max_stderr_bytes?: number;
+    max_output_bytes?: number;
+}
+export interface MswarmArtifactRef {
+    id?: string;
+    uri: string;
+    name?: string;
+    content_type?: string;
+    size_bytes?: number;
+    sha256?: string;
+    scope?: MswarmArtifactScope;
+}
+export interface MswarmArtifactInput {
+    name: string;
+    artifact: MswarmArtifactRef;
+    mount_path?: string;
+    required?: boolean;
+}
+export interface MswarmOutputSpec {
+    name: string;
+    path: string;
+    content_type?: string;
+    required?: boolean;
+}
+export interface MswarmJobRequest {
+    schema_version: MswarmJobSchemaVersion;
+    job_type: MswarmJobType;
+    idempotency_key?: string;
+    runner_hint?: string;
+    inputs?: MswarmArtifactInput[];
+    args?: Record<string, unknown>;
+    resources?: MswarmResourceRequest;
+    limits?: MswarmJobLimits;
+    outputs?: MswarmOutputSpec[];
+    policy: MswarmJobPolicy;
+    metadata?: Record<string, unknown>;
+}
+export interface MswarmJobResult {
+    job_id: string;
+    status: MswarmJobStatus;
+    exit_code?: number;
+    started_at?: string;
+    finished_at?: string;
+    artifacts?: MswarmArtifactRef[];
+    metrics?: Record<string, unknown>;
+    error?: {
+        code: string;
+        message: string;
+        retryable?: boolean;
+    };
+}
+export interface MswarmJobEvent {
+    job_id: string;
+    type: MswarmJobEventType;
+    sequence: number;
+    timestamp: string;
+    message?: string;
+    data?: Record<string, unknown>;
+}
+export interface MswarmGenericJobValidationOptions {
+    /**
+     * Deprecated compatibility input. A registered type name alone is not enough
+     * to validate tenant/package jobs; use registeredJobCatalog instead.
+     */
+    registeredJobTypes?: readonly string[];
+    registeredJobCatalog?: readonly MswarmRegisteredJobCatalogEntry[];
+    allowSignedArtifactUrls?: boolean;
+}
+export interface MswarmGenericJobValidationResult {
+    ok: boolean;
+    value?: MswarmJobRequest;
+    issues: MswarmGenericJobValidationIssue[];
+}
+export declare const MSWARM_KNOWN_JOB_ARG_KEYS: Record<MswarmKnownJobType, readonly string[]>;
+export declare function isMswarmKnownJobType(value: unknown): value is MswarmKnownJobType;
+export declare function isMswarmRegisteredJobType(value: unknown): value is MswarmRegisteredJobType;
+export declare function isMswarmJobType(value: unknown): value is MswarmJobType;
+export declare function validateMswarmGenericJobRequest(input: unknown, options?: MswarmGenericJobValidationOptions): MswarmGenericJobValidationResult;
+export declare function isMswarmGenericJobRequest(input: unknown, options?: MswarmGenericJobValidationOptions): input is MswarmJobRequest;
+//# sourceMappingURL=GenericJobContract.d.ts.map

package/dist/mswarm/GenericJobContract.d.ts.map

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