@kora-platform/cli 0.7.0-rc1 → 0.8.0-rc10

package/dist/api-types.d.ts

@@ -1,4 +1,11 @@
 export type CliRecord = Record<string, unknown>;
+export type WorkspaceCommandDiagnostic = CliRecord & {
+    code: string;
+    gate: "importBlocking" | "importWarnings" | "releaseReadiness" | "releaseBlocking" | "releaseWarnings" | "runtimeBlocking" | "runtimeWarnings";
+    message: string;
+    path?: string;
+    severity: "error" | "warning";
+};
 export type RoleName = "admin" | "member" | "owner" | "viewer";
 export interface ApiKeyRecord extends CliRecord {
     expiresAt?: string | null;
@@ -35,16 +42,102 @@ export interface DeletedOrganizationSummary extends CliRecord {
 }
 export interface OrgSettingsRecord extends CliRecord {
 }
-export interface ImportProjectResult extends CliRecord {
-}
-export interface ProjectWorkspaceSummary extends CliRecord {
+export interface WorkflowNodeTestResult extends CliRecord {
+    nodeId: string;
+    nodeKind?: string;
+    operationName: string;
+    status: "failed" | "invalid" | "passed";
+    testId: string;
+    workflowName: string;
 }
 export interface RuntimeVariableRecord extends CliRecord {
+    environmentKey?: string;
     name: string;
     value: string;
 }
 export interface OrgSecretRecord extends CliRecord {
+    environmentKey?: string;
+    name: string;
+}
+export interface ExtensionPackageFileInput extends CliRecord {
+    contentBase64: string;
+    path: string;
+}
+export interface ExtensionPermissions extends CliRecord {
+    callbacks?: boolean;
+    cloud?: boolean;
+    egress?: string[];
+    schedules?: boolean;
+    secrets?: boolean;
+    storage?: boolean;
+}
+export interface ExtensionInstallRecord extends CliRecord {
+    enabled: boolean;
+    environmentKey?: string;
+    grantedPermissions: ExtensionPermissions;
+    id: string;
+    packageId: string;
+    packageRevisionId: string;
+    slug: string;
+}
+export interface ExtensionPackageRecord extends CliRecord {
+    id: string;
     name: string;
+    orgId: string;
+}
+export interface ExtensionPackageRevisionRecord extends CliRecord {
+    fileCount: number;
+    id: string;
+    packageId: string;
+    revisionHash: string;
+    totalBytes: number;
+    version: string;
+}
+export interface ExtensionPackageValidationDiagnostic extends CliRecord {
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface ExtensionPackageValidationResult extends CliRecord {
+    diagnostics: ExtensionPackageValidationDiagnostic[];
+    fileCount: number;
+    ok: boolean;
+    revisionHash?: string;
+    totalBytes: number;
+}
+export interface ExtensionPackageExportEnvelope extends CliRecord {
+    files: ExtensionPackageFileInput[];
+    metadata: CliRecord & {
+        installId?: string;
+        installSlug?: string;
+        installUpdatedAt?: string;
+        packageRevisionId: string;
+        revisionHash: string;
+        source: string;
+    };
+}
+export interface BuiltInExtensionRecord extends CliRecord {
+    availability: "available" | "unavailable";
+    defaultGrantedPermissions: ExtensionPermissions;
+    description: string;
+    installedSlug: string | null;
+    packageName: string;
+    requiresCloud: boolean;
+    slug: string;
+    source: string;
+    title: string;
+    unavailableReason: string | null;
+}
+export interface ExtensionInstallDetailRecord extends CliRecord {
+    install: ExtensionInstallRecord;
+    package: ExtensionPackageRecord;
+    registrations: CliRecord | null;
+    revision: ExtensionPackageRevisionRecord;
+}
+export interface ExtensionInstallUpdatePlan extends CliRecord {
+    diagnostics: WorkspaceCommandDiagnostic[];
+    mutated: boolean;
+    updateAllowed: boolean;
 }
 export interface ProcessDefinitionSummary extends CliRecord {
 }
@@ -81,127 +174,174 @@ export interface AuthoringOrganizationManagementContext extends CliRecord {
 }
 export interface CapabilityEditorRecord extends CliRecord {
 }
-export interface ConnectorsEditorRecord extends CliRecord {
-    connectors: Array<CliRecord & {
-        name: string;
-    }>;
-}
-export interface McpServersEditorRecord extends CliRecord {
-    servers: Array<CliRecord & {
-        name: string;
-    }>;
-}
 export interface OperationsEditorRecord extends CliRecord {
     operations: Array<CliRecord & {
         name: string;
     }>;
 }
-export interface OrgSkillPackageFileRecord extends CliRecord {
-    content: string;
-    path: string;
-}
-export interface OrgSkillPackageRecord extends CliRecord {
-    id?: string;
-    name?: string;
-    slug: string;
+export type AuditOutcome = "denied" | "failed" | "succeeded";
+export type AuditEventSource = "auth" | "platform";
+export interface AuditEventRecord extends CliRecord {
+    action: string;
+    actorId: string;
+    actorType: string;
+    category: string;
+    correlationId: string | null;
+    createdAt: string;
+    deploymentId: string | null;
+    id: string;
+    metadata: CliRecord;
+    occurredAt: string;
+    orgId: string | null;
+    outcome: AuditOutcome;
+    releaseId: string | null;
+    requestId: string | null;
+    resourceId: string | null;
+    resourceName: string | null;
+    resourceType: string | null;
+    runId: string | null;
+    schemaVersion: number;
+    source: AuditEventSource;
+    sourceEventId: string | null;
+    workflowId: string | null;
+}
+export interface AuditEventListResult extends CliRecord {
+    events: AuditEventRecord[];
+    limit: number;
 }
-export interface OrgSkillPackageRevisionRecord extends CliRecord {
-    revision?: number;
+export interface ReleaseSummaryRecord extends CliRecord {
+    id: string;
 }
-export interface OrgSkillPackageDetailRecord extends CliRecord {
-    files: OrgSkillPackageFileRecord[];
+export interface CreateReleaseResult extends CliRecord {
+    release: ReleaseSummaryRecord;
 }
-export interface CreateOrgSkillPackageInput extends CliRecord {
+export interface ReleaseSourceFileRecord extends CliRecord {
+    content: string;
+    path: string;
 }
-export interface UpdateOrgSkillPackageInput extends CliRecord {
+export interface ReleaseSourceSnapshotRecord extends CliRecord {
+    assets: ReleaseSourceFileRecord[];
+    files: ReleaseSourceFileRecord[];
+    ingestionHistory: CliRecord[];
 }
-export interface UploadOrgSkillPackageRevisionInput extends CliRecord {
+export interface ReleaseValidationDiagnostic extends CliRecord {
+    code: string;
+    gate: "releaseBlocking" | "releaseWarnings";
+    message: string;
+    path: string;
+    severity: string;
 }
-export type OrgMcpServerAuthMode = "none" | "oauth";
-export interface OrgMcpServerRecord extends CliRecord {
-    authMode?: OrgMcpServerAuthMode;
-    displayName?: string;
-    id: string;
-    slug?: string;
-    status?: string;
-    url?: string;
+export interface ReleaseValidationResult extends CliRecord {
+    diagnostics: ReleaseValidationDiagnostic[];
+    releaseId: string;
+    releaseReady: boolean;
 }
-export interface OrgMcpServerDetailRecord extends CliRecord {
-    server: OrgMcpServerRecord;
+export type RuntimeControlActivityFocusType = "run" | "task" | "workflow";
+export interface RuntimeControlActivityReadResult extends CliRecord {
+    events: CliRecord[];
 }
-export interface OrgMcpServerTestResult extends CliRecord {
-    ok: boolean;
-    server: OrgMcpServerRecord & {
-        lastErrorMessage?: string | null;
-        slug: string;
-    };
+export type AgentUsageSourceStatus = "event_only" | "trace_joined";
+export interface AgentUsageSummary extends CliRecord {
+    agentExecutionCount: number;
+    from: string;
+    orgId: string;
+    sourceEventOnlyCount: number;
+    to: string;
+    tokensIn: number;
+    tokensOut: number;
+    toolCallCount: number;
+    usdMicros: number;
+}
+export interface AgentUsageWorkflowSummary extends CliRecord {
+    agentExecutionCount: number;
+    model: string | null;
+    processName: string;
+    provider: string | null;
+    tokensIn: number;
+    tokensOut: number;
+    toolCallCount: number;
+    usdMicros: number;
+}
+export interface AgentToolUsageSummary extends CliRecord {
+    callCount: number;
+    failureCount: number;
+    successCount: number;
+    toolName: string;
+}
+export interface AgentUsageRecentEvent extends CliRecord {
+    eventId: string;
+    model: string | null;
+    occurredAt: string;
+    processName: string;
+    provider: string | null;
+    runId: string;
+    sourceStatus: AgentUsageSourceStatus;
+    status: string;
+    tokensIn: number;
+    tokensOut: number;
+    toolCallCount: number;
+    usdMicros: number;
 }
-export interface OrgMcpServerDiscoveryResult extends CliRecord {
-    server: OrgMcpServerRecord & {
-        slug: string;
-    };
-    tools: Array<CliRecord & {
-        toolName: string;
-    }>;
+export interface AgentUsageReport extends CliRecord {
+    recentEvents: AgentUsageRecentEvent[];
+    summary: AgentUsageSummary;
+    tools: AgentToolUsageSummary[];
+    workflows: AgentUsageWorkflowSummary[];
 }
-export interface OrgMcpServerOAuthActionResult extends CliRecord {
-    server: OrgMcpServerRecord & {
-        slug: string;
-    };
+export interface RuntimeControlDeploymentRecord extends CliRecord {
 }
-export interface OrgMcpServerOAuthConnectResult extends CliRecord {
-    authorizationUrl: string;
-    sessionId: string;
+export interface WorkflowFailureSummary extends CliRecord {
+    causeChain: string[];
+    rootCause: string;
+    rootCauseCode?: string;
+    summary: string;
+    summaryCode?: string;
 }
-export interface OrgMcpServerOAuthSessionRecord extends CliRecord {
-    authorizationUrl?: string;
-    errorMessage?: string | null;
-    expiresAt?: string;
-    id?: string;
+export interface EnvironmentRecord extends CliRecord {
+    currentDeploymentId?: string | null;
+    id: string;
+    isProductionTarget?: boolean;
+    key: string;
+    name: string;
     status: string;
 }
-export interface OrgMcpServerOAuthStatusRecord extends CliRecord {
-    connected?: boolean;
-    status?: string;
-}
-export interface CreateOrgMcpServerInput extends CliRecord {
-    authMode?: OrgMcpServerAuthMode;
-    displayName?: string;
-    slug?: string;
-    timeoutMs?: number;
-    transport?: string;
-    url?: string;
-}
-export interface UpdateOrgMcpServerInput extends CliRecord {
-    authMode?: OrgMcpServerAuthMode;
-    displayName?: string;
-    timeoutMs?: number;
-    transport?: string;
-    url?: string;
-}
-export interface ReleaseSummaryRecord extends CliRecord {
+export interface EnvironmentDeploymentRecord extends CliRecord {
+    appliedAt?: string | null;
+    createdAt?: string;
+    coreDeploymentId?: string | null;
+    environmentId?: string;
+    environmentKey: string;
+    error?: CliRecord | null;
     id: string;
+    isLive: boolean;
+    previousDeploymentId?: string | null;
+    releaseId: string;
+    status: string;
+    updatedAt?: string;
 }
-export interface DeactivateReleaseResult extends CliRecord {
-}
-export interface DraftChangeSummaryRecord extends CliRecord {
-}
-export interface PublishReleaseResult extends CliRecord {
-    release: ReleaseSummaryRecord;
-}
-export interface RetryReleasePublicationResult extends CliRecord {
-}
-export type RuntimeControlActivityFocusType = "run" | "task" | "workflow";
-export interface RuntimeControlActivityReadResult extends CliRecord {
-    events: CliRecord[];
-}
-export interface RuntimeControlDeploymentRecord extends CliRecord {
+export interface EnvironmentDetailRecord extends CliRecord {
+    environment: EnvironmentRecord;
+    latestDeployment: EnvironmentDeploymentRecord | null;
+    liveDeployment: EnvironmentDeploymentRecord | null;
 }
 export interface RuntimeControlOverviewRecord extends CliRecord {
 }
-export interface RuntimeControlRunDetailRecord extends CliRecord {
-}
 export interface RuntimeControlRunRecord extends CliRecord {
+    closeTime?: string | null;
+    deploymentId?: string | null;
+    environmentKey?: string | null;
+    failure?: WorkflowFailureSummary;
+    releaseId?: string | null;
+    startTime?: string;
+    status: string;
+    workflowId: string;
+}
+export interface RuntimeControlRunDetailRecord extends RuntimeControlRunRecord {
+    failureLookupError?: string;
+    historyLength?: number;
+    historySizeBytes?: number;
+    state?: CliRecord | null;
+    stateQueryError?: string;
 }
 export interface RuntimeControlRunStateRecord extends CliRecord {
 }
@@ -221,75 +361,73 @@ export interface CompleteRuntimeTaskResult extends CliRecord {
 }
 export interface AbortRuntimeRunResult extends CliRecord {
 }
+export type RuntimeArtifactProducerType = "review_upload" | "upload" | "workflow_capture" | "workflow_node_test_capture";
+export type RuntimeArtifactAssociationKind = "origin" | "usage";
+export type RuntimeArtifactAssociationRole = "input" | "output" | "review";
+export type RuntimeArtifactLifecycleStatus = "active" | "archived" | "purged";
+export type RuntimeArtifactLifecycleFilter = RuntimeArtifactLifecycleStatus | "all";
+export type RuntimeArtifactByteDeletionStatus = "deleted" | "pending" | "retained";
 export interface RuntimeArtifactRecord extends CliRecord {
-    id?: string;
-    name?: string;
+    archivedAt?: string;
+    artifactId: string;
+    byteDeletionStatus: RuntimeArtifactByteDeletionStatus;
+    bytesDeletedAt?: string;
+    createdAt: string;
+    deploymentId?: string;
+    encryptionKeyId?: string;
+    encryptionMode?: string;
+    expiresAt?: string;
+    fieldKey?: string;
+    fieldPath?: string;
+    folderEntryCount?: number;
+    folderTotalBytes?: number;
+    kind: "file" | "folder";
+    lifecycleStatus: RuntimeArtifactLifecycleStatus;
+    mediaType?: string;
+    name: string;
+    nodeId?: string;
+    producerType: RuntimeArtifactProducerType;
+    purgedAt?: string;
+    scanStatus: "blocked" | "clean" | "failed" | "not_scanned" | "pending";
+    sha256: string;
+    sizeBytes: number;
+    workflowId?: string;
+    workflowName?: string;
+    workflowNodeTestId?: string;
+    workflowRunId?: string;
+}
+export interface RuntimeArtifactAssociationRecord extends CliRecord {
+    artifactId: string;
+    associatedAt: string;
+    associationKind: RuntimeArtifactAssociationKind;
+    deploymentId?: string;
+    fieldKey?: string;
+    fieldPath?: string;
+    nodeId?: string;
+    reviewTaskId?: string;
+    role: RuntimeArtifactAssociationRole;
+    workflowId?: string;
+    workflowName?: string;
+    workflowNodeTestId?: string;
+    workflowRunId?: string;
+}
+export interface RuntimeArtifactAssociationSummary extends CliRecord {
+    inputUsageCount: number;
+    outputOriginCount: number;
+    reviewUsageCount: number;
+}
+export interface RuntimeArtifactInventoryRecord extends CliRecord {
+    artifact: RuntimeArtifactRecord;
+    associationSummary: RuntimeArtifactAssociationSummary;
+    originAssociation: RuntimeArtifactAssociationRecord | null;
+}
+export interface RuntimeArtifactDetailRecord extends CliRecord {
+    artifact: RuntimeArtifactRecord;
+    associations: RuntimeArtifactAssociationRecord[];
 }
 export interface ChatHealth extends CliRecord {
 }
-export interface ChatSessionChangesRecord extends CliRecord {
-}
-export interface ChatSessionDraftApplyRecord extends CliRecord {
-}
-export interface ChatSessionDraftRefreshRecord extends CliRecord {
-}
-export interface ChatSessionDraftRecord extends CliRecord {
-}
 export interface ChatSessionRecord extends CliRecord {
 }
 export interface ChatSessionSummary extends CliRecord {
 }
-export interface ChatSessionValidationRecord extends CliRecord {
-}
-export interface ChatSessionWorkspaceStateRecord extends CliRecord {
-}
-export type ManagedIntegrationJsonValue = ManagedIntegrationJsonObject | ManagedIntegrationJsonValue[] | boolean | null | number | string;
-export interface ManagedIntegrationJsonObject {
-    [key: string]: ManagedIntegrationJsonValue;
-}
-export interface ManagedIntegrationActionInput extends CliRecord {
-    connectionRef?: string;
-    input?: ManagedIntegrationJsonObject;
-}
-export interface ManagedIntegrationActionDescriptor extends CliRecord {
-    cliSafe: boolean;
-    id: string;
-    label?: string;
-}
-export interface ManagedIntegrationSummary extends CliRecord {
-    id: string;
-}
-export interface ManagedIntegrationDiagnostic extends CliRecord {
-    id: string;
-}
-export interface ManagedIntegrationConnectionSummary extends CliRecord {
-    connectionRef: string;
-}
-export interface ManagedIntegrationPromptGuidance extends CliRecord {
-}
-export type ManagedIntegrationHostEffect = {
-    kind: "connection_ready";
-    connectionRef: string;
-    displayName: string;
-} | {
-    kind: "open_external_url";
-    label?: string;
-    url: string;
-} | {
-    kind: "refresh_state";
-    reason?: string;
-} | {
-    kind: "schedule_poll";
-    intervalMs: number;
-    reason?: string;
-} | {
-    kind: "terminal_failure";
-    message: string;
-} | {
-    kind: "user_message";
-    message: string;
-};
-export interface ManagedIntegrationActionResult extends CliRecord {
-    actionId: string;
-    effects: ManagedIntegrationHostEffect[];
-}

package/dist/artifact-api-client.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeArtifactRecord } from "./api-types.js";
+import type { RuntimeArtifactDetailRecord, RuntimeArtifactLifecycleFilter, RuntimeArtifactInventoryRecord, RuntimeArtifactRecord } from "./api-types.js";
 import type { CliSessionState, createPlatformTransport } from "./transport.js";
 type PlatformTransport = ReturnType<typeof createPlatformTransport>;
 type DownloadArtifactOptions = {
@@ -9,6 +9,20 @@ type DownloadArtifactOptions = {
     maxBytes?: number;
     validateHeaders?: (headers: Headers) => void;
 };
+type ListArtifactsFilters = {
+    associationKind?: string;
+    associationRole?: string;
+    createdAfter?: string;
+    createdBefore?: string;
+    lifecycleStatus?: RuntimeArtifactLifecycleFilter;
+    limit?: number;
+    mediaType?: string;
+    nodeId?: string;
+    producerType?: string;
+    runId?: string;
+    workflowNodeTestId?: string;
+    workflowId?: string;
+};
 export declare function createArtifactApiClient(transport: PlatformTransport): {
     uploadArtifact(session: CliSessionState, orgId: string, inputData: {
         body: Uint8Array;
@@ -23,11 +37,24 @@ export declare function createArtifactApiClient(transport: PlatformTransport): {
     }): Promise<{
         artifacts: RuntimeArtifactRecord[];
     }>;
+    listArtifacts(session: CliSessionState, orgId: string, filters: ListArtifactsFilters): Promise<{
+        artifacts: RuntimeArtifactInventoryRecord[];
+    }>;
+    getArtifactDetail(session: CliSessionState, orgId: string, artifactId: string): Promise<RuntimeArtifactDetailRecord>;
     downloadArtifact(session: CliSessionState, orgId: string, artifactId: string, options?: DownloadArtifactOptions): Promise<{
         body: Uint8Array<ArrayBufferLike>;
         contentType: string;
         fileName: string | null;
         sizeBytes: number;
     }>;
+    archiveArtifact(session: CliSessionState, orgId: string, artifactId: string): Promise<{
+        artifact: RuntimeArtifactRecord;
+    }>;
+    restoreArtifact(session: CliSessionState, orgId: string, artifactId: string): Promise<{
+        artifact: RuntimeArtifactRecord;
+    }>;
+    purgeArtifact(session: CliSessionState, orgId: string, artifactId: string): Promise<{
+        artifact: RuntimeArtifactRecord;
+    }>;
 };
 export {};

package/dist/artifact-api-client.js

@@ -20,6 +20,18 @@ export function createArtifactApiClient(transport) {
                 session
             });
         },
+        async listArtifacts(session, orgId, filters) {
+            return transport.requestJson({
+                path: withQuery(`/api/v1/orgs/${encodeURIComponent(orgId)}/artifacts`, filters),
+                session
+            });
+        },
+        async getArtifactDetail(session, orgId, artifactId) {
+            return transport.requestJson({
+                path: `/api/v1/orgs/${encodeURIComponent(orgId)}/artifacts/${encodeURIComponent(artifactId)}`,
+                session
+            });
+        },
         async downloadArtifact(session, orgId, artifactId, options = {}) {
             const response = await transport.requestBytes({
                 ...(options.createMaxBytesError ? { createMaxBytesError: options.createMaxBytesError } : {}),
@@ -34,6 +46,27 @@ export function createArtifactApiClient(transport) {
                 fileName: readContentDispositionFileName(response.headers.get("content-disposition")),
                 sizeBytes: response.body.byteLength
             };
+        },
+        async archiveArtifact(session, orgId, artifactId) {
+            return transport.requestJson({
+                method: "POST",
+                path: `/api/v1/orgs/${encodeURIComponent(orgId)}/artifacts/${encodeURIComponent(artifactId)}/archive`,
+                session
+            });
+        },
+        async restoreArtifact(session, orgId, artifactId) {
+            return transport.requestJson({
+                method: "POST",
+                path: `/api/v1/orgs/${encodeURIComponent(orgId)}/artifacts/${encodeURIComponent(artifactId)}/restore`,
+                session
+            });
+        },
+        async purgeArtifact(session, orgId, artifactId) {
+            return transport.requestJson({
+                method: "POST",
+                path: `/api/v1/orgs/${encodeURIComponent(orgId)}/artifacts/${encodeURIComponent(artifactId)}/purge`,
+                session
+            });
         }
     };
 }

package/dist/artifact-commands.d.ts

@@ -10,6 +10,11 @@ type ResolveOrgScope = (parsed: ParsedCommand, context: CommandExecutionContext,
 }>;
 export declare function executeArtifactUpload(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
 export declare function executeArtifactList(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
+export declare function executeArtifactInventory(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
+export declare function executeArtifactInspect(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
 export declare function executeArtifactDownload(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
 export declare function executeArtifactRead(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
+export declare function executeArtifactArchive(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
+export declare function executeArtifactRestore(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
+export declare function executeArtifactPurge(parsed: ParsedCommand, context: CommandExecutionContext, api: ReturnType<typeof createPlatformApiClient>, resolveOrgScope: ResolveOrgScope): Promise<ExecutedCommand>;
 export {};