@sayknow-cli/coding-agent 0.3.16 → 0.4.1

package/dist/types/skc-runtime/state-writer.d.ts

@@ -1,244 +0,0 @@
-import type { Stats } from "node:fs";
-import { type FileLockOptions } from "../config/file-lock";
-import type { SkillActiveEntry } from "../skill-state/active-state";
-import { type AuditEntry, type CanonicalSkcWorkflowSkill, type WorkflowStateMutationOwner } from "../skill-state/workflow-state-contract";
-/**
- * Sole sanctioned project `.skc/**` writer module (gate G1).
- *
- * All native `.skc/**` filesystem mutations must route through these primitives.
- * The primitives validate project `.skc/**` ownership, create parent directories,
- * and emit workflow receipts or audit entries where applicable by the caller's
- * supplied mutation context. No lockfiles are used; isolation is by atomic rename,
- * append, O_EXCL creates, conditional deletes, per-entry active-state files,
- * and derived active-state snapshots.
- * Transaction journals are per mutation id under the session state transactions directory;
- * they are recovery evidence only, never global locks or waiters, so stale
- * journals do not block unrelated state reads or writes.
- */
-export type WriterCategory = "state" | "artifact" | "ledger" | "log" | "report" | "agents" | "prune" | "force" | "transaction";
-export interface StateWriterReceiptContext {
-    cwd?: string;
-    skill: CanonicalSkcWorkflowSkill;
-    owner: WorkflowStateMutationOwner;
-    command: string;
-    sessionId?: string;
-    mutationId?: string;
-    nowIso?: string;
-    verb?: string;
-    fromPhase?: string;
-    toPhase?: string;
-    forced?: boolean;
-}
-export interface StateWriterAuditContext {
-    cwd?: string;
-    sessionId?: string;
-    category: WriterCategory;
-    verb: string;
-    owner: WorkflowStateMutationOwner;
-    skill?: CanonicalSkcWorkflowSkill | string;
-    mutationId?: string;
-    fromPhase?: string;
-    toPhase?: string;
-    forced?: boolean;
-}
-export interface WorkflowEnvelopeIntegrityMismatch {
-    path: string;
-    expected: string;
-    actual: string;
-}
-export interface WorkflowTransactionJournal {
-    version: 1;
-    mutation_id: string;
-    status: "pending" | "committed";
-    created_at: string;
-    updated_at: string;
-    caller?: CanonicalSkcWorkflowSkill;
-    callee?: CanonicalSkcWorkflowSkill;
-    paths: string[];
-    steps: string[];
-}
-export type StateWritePolicy = "source" | "cache";
-export interface GuardedStateWriterOptions extends StateWriterOptions {
-    policy: StateWritePolicy;
-    expectedRevision?: number;
-    sourceRevision?: number;
-}
-export type GuardedWriteResult = {
-    path: string;
-    written: true;
-    revision: number;
-    stamped: unknown;
-} | {
-    path: string;
-    written: false;
-    reason: "stale-skip";
-    revision: number;
-};
-export interface StateWriterOptions {
-    cwd?: string;
-    receipt?: StateWriterReceiptContext;
-    audit?: StateWriterAuditContext;
-    sourceRevision?: number;
-    /**
-     * Cross-process lock tuning for read-modify-write paths that route through
-     * `withWorkflowStateLock` / `updateJsonAtomic`. Omit for the hardened
-     * `withFileLock` defaults.
-     */
-    lock?: FileLockOptions;
-}
-export declare class StateWriteConflictError extends Error {
-    readonly path: string;
-    readonly expectedRevision: number;
-    readonly persistedRevision: number;
-    constructor(path: string, expectedRevision: number, persistedRevision: number);
-}
-export interface DeleteIfOwnedOptions extends StateWriterOptions {
-    predicate?: (current: unknown) => boolean | Promise<boolean>;
-}
-export interface DeleteResult {
-    path: string;
-    deleted: boolean;
-}
-export interface ActiveSessionScope {
-    sessionId?: string;
-}
-export interface ActiveEntryWriteResult {
-    entryPath: string;
-    snapshotPath: string;
-}
-export interface HardPruneSelectorContext {
-    path: string;
-    value: unknown;
-}
-export interface GenericHardPruneTarget {
-    path: string;
-    category: WriterCategory | string;
-}
-export interface GenericHardPruneSelectorContext {
-    path: string;
-    category: WriterCategory | string;
-    stat: Stats;
-    readJson: () => Promise<unknown>;
-}
-export type GenericHardPruneSelector = (context: GenericHardPruneSelectorContext) => boolean | Promise<boolean>;
-export interface ForceOverwriteOptions extends StateWriterOptions {
-    raw?: boolean;
-}
-export type HardPruneSelector = (context: HardPruneSelectorContext) => boolean | Promise<boolean>;
-export declare class AlreadyExistsError extends Error {
-    readonly path: string;
-    constructor(path: string);
-}
-export type StrictMutationReadResult = {
-    kind: "absent";
-} | {
-    kind: "corrupt";
-    error: string;
-} | {
-    kind: "valid";
-    value: Record<string, unknown>;
-};
-export declare function readExistingStateForMutation(filePath: string): Promise<StrictMutationReadResult>;
-export declare function workflowEnvelopeContentSha256(value: unknown): string;
-export declare function stampWorkflowEnvelopeChecksum<T>(value: T, filePath: string, computedAt?: string): T;
-export declare function detectWorkflowEnvelopeIntegrityMismatch(filePath: string): Promise<WorkflowEnvelopeIntegrityMismatch | undefined>;
-type ActiveStateCacheInvalidator = (cwd?: string, sessionId?: string) => void;
-export declare function setActiveStateCacheInvalidator(invalidator: ActiveStateCacheInvalidator): void;
-export declare function persistedStateRevision(value: unknown): number;
-export declare function writeGuardedJsonAtomic(targetPath: string, value: unknown, options: GuardedStateWriterOptions): Promise<GuardedWriteResult>;
-export declare function writeGuardedWorkflowEnvelopeAtomic(targetPath: string, value: unknown, options: GuardedStateWriterOptions): Promise<GuardedWriteResult>;
-export declare function writeJsonAtomic(targetPath: string, value: unknown, options?: StateWriterOptions): Promise<string>;
-export declare function writeWorkflowEnvelopeAtomic(targetPath: string, value: unknown, options?: StateWriterOptions): Promise<string>;
-export declare function writeTextAtomic(targetPath: string, text: string, options?: StateWriterOptions): Promise<string>;
-/**
- * Serialize a read-modify-write (or any multi-step mutation) against concurrent
- * writers of the same `.skc/**` target. Uses the cross-process directory lock
- * from `withFileLock`, keyed on the resolved file path, so separate CLI/agent
- * processes (e.g. team-mode workers) cannot interleave one writer's read with
- * another writer's write and silently drop the first mutation (issue #646).
- *
- * The lock is advisory: it only protects callers that route through it, so every
- * read-modify-write of a given file MUST acquire this lock for the same resolved
- * path. `atomicWrite`'s temp-file + rename crash-atomicity is preserved; this
- * layers concurrency-atomicity on top without weakening it.
- */
-export declare function withWorkflowStateLock<T>(targetPath: string, fn: () => Promise<T>, options?: StateWriterOptions): Promise<T>;
-export declare function updateJsonAtomic<T = unknown>(targetPath: string, mutator: (current: T | undefined) => T | Promise<T>, options?: StateWriterOptions): Promise<string>;
-export declare function appendJsonl(targetPath: string, entry: unknown, options?: StateWriterOptions): Promise<string>;
-export interface AppendJsonlIdempotentOptions extends StateWriterOptions {
-    /**
-     * Identity key for an entry. Two entries that produce the same non-`undefined`
-     * key are duplicates, so only the first is appended. Return `undefined` to opt a
-     * candidate out of dedup (it is always appended). Use `key` for the common case
-     * where identity reduces to a single string.
-     */
-    key?: (entry: unknown) => string | undefined;
-    /**
-     * Equivalence predicate: return `true` when `existing` already represents
-     * `candidate`, suppressing the append. Use when identity cannot be reduced to a
-     * single string key. When both `key` and `equals` are supplied, `equals` wins.
-     */
-    equals?: (candidate: unknown, existing: unknown) => boolean;
-}
-export interface AppendJsonlIdempotentResult {
-    path: string;
-    /** `true` when the entry was written; `false` when an equivalent entry already existed. */
-    appended: boolean;
-    /** The pre-existing entry that suppressed the append, when `appended` is `false`. */
-    duplicate?: unknown;
-}
-/**
- * Append `entry` to a JSONL file only when no equivalent entry already exists —
- * the shared idempotent append primitive (issue #660).
- *
- * `appendJsonl` is a pure append with no dedup, so every recurring "duplicate
- * ledger row" bug (#638, #643, #645) had to be patched with bespoke per-call-site
- * guards. This primitive centralizes the read-check-append cycle: a caller
- * declares identity once via `key` or `equals` instead of re-deriving the lookup
- * at each site.
- *
- * The read-then-append is serialized through the same cross-process workflow lock
- * as `updateJsonAtomic`, so two concurrent idempotent appends cannot both observe
- * "no duplicate" and both write (the #646 TOCTOU that a plain `appendJsonl`
- * preceded by a manual existence check is still exposed to).
- *
- * Scope note: this dedups the *append* only. Call sites whose idempotency must
- * also skip a coupled mutation — e.g. the plan/state rewrite in #643/#645 — still
- * need a whole-operation guard; this primitive is the ledger-level half of that.
- */
-export declare function appendJsonlIdempotent(targetPath: string, entry: unknown, options: AppendJsonlIdempotentOptions): Promise<AppendJsonlIdempotentResult>;
-export declare function appendText(targetPath: string, text: string, options?: StateWriterOptions): Promise<string>;
-export declare function createJsonNoClobber(targetPath: string, value: unknown, options?: StateWriterOptions): Promise<string>;
-export declare function deleteIfOwned(targetPath: string, predicateOrOptions?: ((current: unknown) => boolean | Promise<boolean>) | DeleteIfOwnedOptions): Promise<DeleteResult>;
-export declare function removeFileAudited(targetPath: string, options?: StateWriterOptions): Promise<DeleteResult>;
-/**
- * Active entry files under `.skc/_session-{id}/state/active/<skill>.json` are authoritative. The
- * adjacent `skill-active-state.json` file is only a derived cache rebuilt from
- * those entries, so concurrent snapshot rebuilds can race without losing any
- * writer's per-skill state.
- */
-export declare function writeActiveEntry(cwd: string, sessionScope: string | ActiveSessionScope | undefined, skill: string, entry: SkillActiveEntry, options?: StateWriterOptions): Promise<string>;
-export declare function removeActiveEntry(cwd: string, sessionScope: string | ActiveSessionScope | undefined, skill: string, options?: StateWriterOptions): Promise<DeleteResult>;
-export declare function readActiveEntries(cwd: string, sessionScope?: string | ActiveSessionScope): Promise<SkillActiveEntry[]>;
-export declare function rebuildActiveSnapshot(cwd: string, sessionScope?: string | ActiveSessionScope, options?: StateWriterOptions): Promise<string>;
-export declare function mergeActiveState(cwd: string, sessionScope: string | ActiveSessionScope | undefined, skill: string, entry: SkillActiveEntry, options?: StateWriterOptions): Promise<ActiveEntryWriteResult>;
-export declare function writeArtifact(targetPath: string, content: string, options?: StateWriterOptions): Promise<string>;
-export declare function writeReport(targetPath: string, content: string, options?: StateWriterOptions): Promise<string>;
-export declare function writeLogJsonl(targetPath: string, entry: unknown, options?: StateWriterOptions): Promise<string>;
-export declare function softDelete(targetPath: string, meta: Record<string, unknown>, options?: StateWriterOptions): Promise<string>;
-export declare function hardPruneJson(targetPaths: readonly string[], selector: HardPruneSelector, options?: StateWriterOptions): Promise<string[]>;
-export declare function hardPrune(targets: readonly GenericHardPruneTarget[], selector: GenericHardPruneSelector, options?: StateWriterOptions): Promise<string[]>;
-export declare function forceOverwrite(targetPath: string, rawValue: unknown, options?: ForceOverwriteOptions): Promise<string>;
-export declare function appendAuditEntry(cwd: string, sessionIdOrEntry: string | AuditEntry, maybeEntry?: AuditEntry): Promise<string>;
-export declare function readWorkflowTransactionJournal(cwd: string, sessionId: string, mutationId: string): Promise<WorkflowTransactionJournal | undefined>;
-export declare function beginWorkflowTransactionJournal(input: {
-    cwd: string;
-    sessionId: string;
-    mutationId: string;
-    caller?: CanonicalSkcWorkflowSkill;
-    callee?: CanonicalSkcWorkflowSkill;
-    paths: string[];
-}): Promise<string>;
-export declare function updateWorkflowTransactionJournal(cwd: string, sessionId: string, mutationId: string, patch: Partial<WorkflowTransactionJournal>): Promise<string>;
-export declare function completeWorkflowTransactionJournal(cwd: string, sessionId: string, mutationId: string): Promise<void>;
-export {};

package/dist/types/skc-runtime/team-gc.d.ts

@@ -1,7 +0,0 @@
-/**
- * GC adapter for team workers (`.skc/state/team/<name>/workers/<id>/` heartbeat
- * + lifecycle). Liveness-only: numeric PID status dominates lifecycle/heartbeat
- * signals.
- */
-import type { GcStoreAdapter } from "./gc-runtime";
-export declare const teamWorkersGcAdapter: GcStoreAdapter;

package/dist/types/skc-runtime/team-runtime.d.ts

@@ -1,355 +0,0 @@
-import type { WorkflowHudSummary } from "../skill-state/active-state";
-import type { GcPidProbe, GcRecord } from "./gc-runtime";
-export type SkcTeamPhase = "starting" | "running" | "awaiting_integration" | "complete" | "failed" | "cancelled";
-export type SkcTeamTaskStatus = "pending" | "blocked" | "in_progress" | "completed" | "failed";
-export type SkcWorkerStatusState = "idle" | "working" | "blocked" | "done" | "failed" | "draining" | "unknown";
-export type SkcTeamWorkerLifecycleState = "starting" | "ready" | "working" | "draining" | "stopped" | "failed" | "unknown";
-export type SkcTeamShutdownMode = "graceful" | "force" | "abort";
-export declare const SKC_TEAM_DEFAULT_WORKERS = 3;
-export declare const SKC_TEAM_MAX_WORKERS = 20;
-export type SkcTeamWorkerCli = "skc";
-export interface SkcTeamLeader {
-    session_id: string;
-    pane_id: string;
-    cwd: string;
-}
-export interface SkcTeamWorker {
-    id: string;
-    name: string;
-    index: number;
-    agent_type: string;
-    role: string;
-    pane_id?: string;
-    status: "starting" | "idle" | "busy" | "stopped";
-    last_heartbeat: string;
-    assigned_tasks: string[];
-    worktree_repo_root?: string;
-    worktree_path?: string;
-    worktree_branch?: string | null;
-    worktree_detached?: boolean;
-    worktree_created?: boolean;
-    worktree_base_ref?: string;
-    team_state_root?: string;
-}
-export interface SkcTeamTaskClaim {
-    owner: string;
-    token: string;
-    leased_until: string;
-}
-export type SkcTeamTaskCompletionEvidenceKind = "command" | "inspection" | "artifact";
-export type SkcTeamTaskCompletionEvidenceStatus = "passed" | "failed" | "not_run" | "verified" | "rejected";
-export interface SkcTeamTaskCompletionEvidenceItem {
-    kind: SkcTeamTaskCompletionEvidenceKind;
-    status: SkcTeamTaskCompletionEvidenceStatus;
-    summary: string;
-    command?: string;
-    artifact?: string;
-    location?: string;
-    output?: string;
-}
-export interface SkcTeamTaskCompletionEvidence {
-    summary: string;
-    items: SkcTeamTaskCompletionEvidenceItem[];
-    files?: string[];
-    notes?: string;
-    recorded_by: string;
-    recorded_at: string;
-}
-export interface SkcTeamTask {
-    id: string;
-    subject: string;
-    description: string;
-    title: string;
-    objective: string;
-    status: SkcTeamTaskStatus;
-    assignee?: string;
-    owner?: string;
-    result?: string;
-    completion_evidence?: SkcTeamTaskCompletionEvidence;
-    error?: string;
-    blocked_by?: string[];
-    depends_on?: string[];
-    lane?: string;
-    required_role?: string;
-    allowed_roles?: string[];
-    version: number;
-    claim?: SkcTeamTaskClaim;
-    created_at: string;
-    updated_at: string;
-    completed_at?: string;
-}
-export type SkcTeamWorktreeMode = {
-    enabled: false;
-} | {
-    enabled: true;
-    detached: true;
-    name: null;
-} | {
-    enabled: true;
-    detached: false;
-    name: string;
-};
-export interface SkcTeamConfig {
-    team_name: string;
-    display_name: string;
-    requested_name: string;
-    task: string;
-    agent_type: string;
-    worker_count: number;
-    max_workers: number;
-    state_root: string;
-    worker_command: string;
-    worker_cli_plan: SkcTeamWorkerCli[];
-    tmux_command: string;
-    tmux_session: string;
-    tmux_session_name: string;
-    tmux_target: string;
-    workspace_mode: "direct" | "worktree";
-    dry_run: boolean;
-    leader: SkcTeamLeader;
-    leader_cwd: string;
-    team_state_root: string;
-    workers: SkcTeamWorker[];
-    created_at: string;
-    updated_at: string;
-}
-export type SkcTeamIntegrationStatus = "idle" | "integrated" | "integration_failed" | "merge_conflict" | "cherry_pick_conflict" | "rebase_conflict";
-export interface SkcTeamWorkerIntegrationState {
-    last_seen_head?: string;
-    last_integrated_head?: string;
-    last_leader_head?: string;
-    last_rebased_leader_head?: string;
-    status?: SkcTeamIntegrationStatus;
-    conflict_commit?: string;
-    conflict_files?: string[];
-    updated_at?: string;
-}
-export interface SkcTeamMonitorSnapshot {
-    integration_by_worker: Record<string, SkcTeamWorkerIntegrationState>;
-    updated_at: string;
-}
-export interface SkcTeamWorkerLifecycle {
-    worker: string;
-    lifecycle_state: SkcTeamWorkerLifecycleState;
-    worker_status_state: SkcWorkerStatusState;
-    pane_id?: string;
-    pid?: number;
-    started_at?: string;
-    updated_at: string;
-    stopped_at?: string;
-    stop_reason?: string;
-    shutdown_request_id?: string;
-    shutdown_requested_at?: string;
-    shutdown_acknowledged_at?: string;
-    shutdown_ack_status?: string;
-    shutdown_mode?: SkcTeamShutdownMode;
-}
-export type SkcTeamNotificationDeliveryState = "pending" | "sent" | "queued" | "deferred" | "failed" | "delivered" | "acknowledged";
-export type SkcTeamPaneAttemptResult = "sent" | "queued" | "deferred" | "failed";
-export interface SkcTeamNotification {
-    id: string;
-    kind: "mailbox_message" | "worker_lifecycle" | "invalid_attempt";
-    team_name: string;
-    recipient: string;
-    source: {
-        type: "message" | "task" | "worker" | "event";
-        id: string;
-    };
-    idempotency_key?: string;
-    delivery_state: SkcTeamNotificationDeliveryState;
-    pane_attempt_result?: SkcTeamPaneAttemptResult;
-    pane_attempt_reason?: string;
-    pane_attempt_at?: string;
-    created_at: string;
-    updated_at: string;
-    replay_count: number;
-}
-export interface SkcTeamNotificationSummary {
-    total: number;
-    replay_eligible: number;
-    by_state: Record<SkcTeamNotificationDeliveryState, number>;
-}
-export interface SkcTeamSnapshot {
-    team_name: string;
-    display_name: string;
-    phase: SkcTeamPhase;
-    state_dir: string;
-    tmux_session: string;
-    tmux_session_name: string;
-    tmux_target: string;
-    task_total: number;
-    task_counts: Record<SkcTeamTaskStatus, number>;
-    workers: SkcTeamWorker[];
-    integration_by_worker?: Record<string, SkcTeamWorkerIntegrationState>;
-    worker_lifecycle_by_id: Record<string, SkcTeamWorkerLifecycle>;
-    notification_summary: SkcTeamNotificationSummary;
-    updated_at: string;
-}
-export interface SkcTeamSnapshotOptions {
-    reconcileNotifications?: boolean;
-}
-export interface SkcTeamStartOptions {
-    workerCount: number;
-    agentType: string;
-    task: string;
-    teamName?: string;
-    worktreeMode?: SkcTeamWorktreeMode;
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-    dryRun?: boolean;
-}
-export interface SkcTeamApiClaimResult {
-    ok: boolean;
-    task?: SkcTeamTask;
-    worker_id?: string;
-    claim_token?: string;
-    reason?: string;
-}
-export type SkcTeamLivenessRecoveryReason = "claim_expired" | "stale_heartbeat" | "missing_pane" | "worker_lifecycle_failed" | "worker_lifecycle_stopped";
-export interface SkcTeamRecoveredClaim {
-    task_id: string;
-    worker: string;
-    reasons: SkcTeamLivenessRecoveryReason[];
-}
-export interface SkcTeamLivenessRecoveryResult {
-    recovered_claims: SkcTeamRecoveredClaim[];
-    stale_workers: Record<string, SkcTeamLivenessRecoveryReason[]>;
-}
-export interface SkcTeamMailboxMessage {
-    message_id: string;
-    from_worker: string;
-    to_worker: string;
-    body: string;
-    created_at: string;
-    delivered_at?: string;
-    notified_at?: string;
-    idempotency_key?: string;
-}
-export declare function resolveSkcTeamWorkerCli(env?: NodeJS.ProcessEnv): SkcTeamWorkerCli;
-export declare function resolveSkcTeamWorkerCliPlan(workerCount: number, env?: NodeJS.ProcessEnv): SkcTeamWorkerCli[];
-export declare function translateSkcWorkerLaunchArgsForCli(workerCli: SkcTeamWorkerCli, args: string[]): string[];
-export interface SkcTeamEvent {
-    event_id: string;
-    ts: string;
-    type: string;
-    worker?: string;
-    task_id?: string;
-    message?: string;
-    data?: Record<string, unknown>;
-}
-export interface SkcTeamTraceEvent {
-    schema_version: 1;
-    trace_id: string;
-    span_id: string;
-    source_event_id: string;
-    event_type: string;
-    ts: string;
-    worker?: string;
-    task_id?: string;
-    message?: string;
-    evidence_refs?: string[];
-    data?: Record<string, unknown>;
-}
-interface WorkerStatusFile {
-    state: SkcWorkerStatusState;
-    current_task_id?: string;
-    reason?: string;
-    updated_at: string;
-}
-interface WorkerHeartbeatFile {
-    pid: number;
-    last_turn_at: string;
-    turn_count: number;
-    alive: boolean;
-}
-export interface SkcWorkerIntegrationAttemptRequestResult {
-    requested: boolean;
-    reason: "requested" | "not_worker" | "missing_worktree" | "no_changes" | "deduped" | "git_error";
-    worker?: string;
-    team_name?: string;
-    fingerprint?: string;
-    head?: string | null;
-    status?: SkcWorkerCheckpointClassification["kind"];
-}
-export declare const SKC_TEAM_API_OPERATIONS: readonly ["send-message", "broadcast", "mailbox-list", "mailbox-mark-delivered", "mailbox-mark-notified", "notification-list", "notification-read", "notification-replay", "notification-mark-pane-attempt", "worker-startup-ack", "create-task", "read-task", "list-tasks", "update-task", "claim-task", "transition-task-status", "transition-task", "release-task-claim", "read-config", "read-manifest", "read-worker-status", "update-worker-status", "read-worker-heartbeat", "recover-stale-claims", "update-worker-heartbeat", "write-worker-inbox", "write-worker-identity", "append-event", "read-events", "read-traces", "await-event", "write-shutdown-request", "read-shutdown-ack", "read-monitor-snapshot", "write-monitor-snapshot", "read-task-approval", "write-task-approval"];
-export declare function resolveSkcTeamStateRoot(cwd?: string, env?: NodeJS.ProcessEnv): string;
-/** @internal */
-export declare function listTeamWorkerGcRecords(teamRoot: string, probe: GcPidProbe): Promise<GcRecord[]>;
-/** @internal */
-export declare function pruneTeamWorkerGcRecord(record: GcRecord, probe: GcPidProbe): Promise<boolean>;
-export declare function persistSkcTeamModeStateSummary(snapshot: SkcTeamSnapshot, cwd?: string): Promise<void>;
-export declare function recoverSkcTeamStaleClaims(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamLivenessRecoveryResult>;
-type SkcTeamTaskMetadataInput = Partial<Pick<SkcTeamTask, "owner" | "lane" | "required_role" | "allowed_roles" | "depends_on" | "blocked_by">>;
-export declare function resolveSkcWorkerCommand(cwd?: string, env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, argv?: string[], execPath?: string): string;
-/** @internal Exported for unit tests. */
-export declare function buildWorkerCommand(config: SkcTeamConfig, worker: SkcTeamWorker, platform?: NodeJS.Platform): string;
-export type SkcWorkerCheckpointClassification = {
-    kind: "clean";
-    files: string[];
-} | {
-    kind: "eligible";
-    files: string[];
-} | {
-    kind: "protected_only";
-    files: string[];
-} | {
-    kind: "conflicted";
-    files: string[];
-} | {
-    kind: "git_error";
-    files: string[];
-    detail: string;
-};
-export declare function classifySkcTeamCheckpointFiles(files: string[]): {
-    eligible: string[];
-    protected: string[];
-};
-export declare function classifyWorkerCheckpointStatus(cwd: string): SkcWorkerCheckpointClassification;
-export declare function startSkcTeam(options: SkcTeamStartOptions): Promise<SkcTeamSnapshot>;
-export declare function readSkcTeamSnapshot(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv, options?: SkcTeamSnapshotOptions): Promise<SkcTeamSnapshot>;
-export declare function monitorSkcTeamSnapshot(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamSnapshot>;
-export declare function requestSkcWorkerIntegrationAttempt(cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcWorkerIntegrationAttemptRequestResult>;
-export declare function buildTeamHudSummary(snapshot: SkcTeamSnapshot, latestEvent?: SkcTeamEvent, latestMessage?: SkcTeamMailboxMessage): Promise<WorkflowHudSummary>;
-export declare function monitorSkcTeam(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamSnapshot>;
-export declare function listSkcTeams(cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamSnapshot[]>;
-export declare function shutdownSkcTeam(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamSnapshot>;
-export declare function listSkcTeamTasks(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamTask[]>;
-export declare function readSkcTeamTask(teamName: string, taskId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamTask>;
-export declare function createSkcTeamTask(teamName: string, subject: string, description: string, cwd?: string, env?: NodeJS.ProcessEnv, taskOptions?: SkcTeamTaskMetadataInput): Promise<SkcTeamTask>;
-export declare function updateSkcTeamTask(teamName: string, taskId: string, updates: Partial<Pick<SkcTeamTask, "subject" | "description" | "blocked_by" | "depends_on" | "lane" | "required_role" | "allowed_roles">>, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamTask>;
-export declare function claimSkcTeamTask(teamName: string, workerId: string, cwd?: string, env?: NodeJS.ProcessEnv, taskId?: string): Promise<SkcTeamApiClaimResult>;
-export declare function transitionSkcTeamTaskStatus(teamName: string, taskId: string, status: SkcTeamTaskStatus, cwd?: string, env?: NodeJS.ProcessEnv, claimToken?: string, workerId?: string, completionEvidenceInput?: unknown): Promise<SkcTeamTask>;
-export declare function transitionSkcTeamTask(teamName: string, taskId: string, status: SkcTeamTaskStatus | "complete", cwd?: string, env?: NodeJS.ProcessEnv, claimToken?: string, completionEvidenceInput?: unknown): Promise<SkcTeamTask>;
-export declare function releaseSkcTeamTaskClaim(teamName: string, taskId: string, claimToken: string, workerId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamTask>;
-export declare function replaySkcTeamNotifications(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
-    notifications: SkcTeamNotification[];
-    summary: SkcTeamNotificationSummary;
-}>;
-export declare function sendSkcTeamMessage(teamName: string, fromWorker: string, toWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv, idempotencyKey?: string): Promise<SkcTeamMailboxMessage>;
-export declare function broadcastSkcTeamMessage(teamName: string, fromWorker: string, body: string, cwd?: string, env?: NodeJS.ProcessEnv, idempotencyKey?: string): Promise<SkcTeamMailboxMessage[]>;
-export declare function listSkcTeamMailbox(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamMailboxMessage[]>;
-export declare function markSkcTeamMailboxMessage(teamName: string, worker: string, messageId: string, field: "delivered_at" | "notified_at", cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamMailboxMessage>;
-export declare function readSkcWorkerStatus(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerStatusFile>;
-export declare function updateSkcWorkerStatus(teamName: string, worker: string, status: SkcWorkerStatusState, cwd?: string, env?: NodeJS.ProcessEnv, currentTaskId?: string, reason?: string): Promise<WorkerStatusFile>;
-export declare function readSkcWorkerHeartbeat(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerHeartbeatFile | null>;
-export declare function updateSkcWorkerHeartbeat(teamName: string, worker: string, heartbeat: WorkerHeartbeatFile, cwd?: string, env?: NodeJS.ProcessEnv): Promise<WorkerHeartbeatFile>;
-export declare function writeSkcWorkerInbox(teamName: string, worker: string, content: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
-    path: string;
-}>;
-export declare function writeSkcWorkerIdentity(teamName: string, worker: SkcTeamWorker, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamWorker>;
-export declare function readSkcTeamEvents(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamEvent[]>;
-export declare function readSkcTeamTraces(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamTraceEvent[]>;
-export declare function appendSkcTeamEvent(teamName: string, type: string, worker?: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<SkcTeamEvent>;
-export declare function awaitSkcTeamEvent(teamName: string, _timeoutMs?: number, cwd?: string, env?: NodeJS.ProcessEnv): Promise<{
-    status: "event" | "timeout";
-    event?: SkcTeamEvent;
-}>;
-export declare function writeSkcMonitorSnapshot(teamName: string, snapshot: unknown, cwd?: string, env?: NodeJS.ProcessEnv): Promise<unknown>;
-export declare function readSkcMonitorSnapshot(teamName: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<unknown>;
-export declare function writeSkcTaskApproval(teamName: string, taskId: string, approval: Record<string, unknown>, cwd?: string, env?: NodeJS.ProcessEnv): Promise<Record<string, unknown>>;
-export declare function readSkcTaskApproval(teamName: string, taskId: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<Record<string, unknown> | null>;
-export declare function writeSkcShutdownRequest(teamName: string, worker: string, requestedBy: string, cwd?: string, env?: NodeJS.ProcessEnv, requestId?: string, mode?: SkcTeamShutdownMode, requestedAt?: string): Promise<Record<string, unknown>>;
-export declare function readSkcShutdownAck(teamName: string, worker: string, cwd?: string, env?: NodeJS.ProcessEnv): Promise<Record<string, unknown> | null>;
-export declare function executeSkcTeamApiOperation(operation: string, input: Record<string, unknown>, cwd?: string, env?: NodeJS.ProcessEnv): Promise<unknown>;
-export declare function parseTeamLaunchArgs(argv: string[]): SkcTeamStartOptions;
-export {};