@kitman-sh/sdk 0.10.82 → 0.10.83

package/types/packages/core/src/change-request.d.ts

@@ -0,0 +1,288 @@
+import * as Schema from 'effect/Schema';
+import { ActorType } from './common';
+export declare const ChangeRequestStatuses: readonly ['draft', 'open', 'closed', 'merged'];
+export declare const ChangeRequestStatus: Schema.Literals<readonly ["draft", "open", "closed", "merged"]>;
+export declare const ChangeRequestProviderRef: Schema.Struct<{
+    readonly provider: Schema.Literals<readonly ["github", "gitlab", "forgejo", "gitea", "gitee", "bitbucket", "azure-devops", "generic_git"]>;
+    readonly host: Schema.String;
+    readonly owner: Schema.String;
+    readonly repositoryName: Schema.String;
+    readonly providerRepositoryId: Schema.String;
+    readonly url: Schema.String;
+    readonly externalId: Schema.String;
+}>;
+export declare const ChangeRequestProviderMetadata: Schema.Struct<{
+    readonly headCommitSha: Schema.optionalKey<Schema.String>;
+    readonly baseCommitSha: Schema.optionalKey<Schema.String>;
+    readonly bodyDigest: Schema.optionalKey<Schema.String>;
+    readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    readonly mergeable: Schema.optionalKey<Schema.Boolean>;
+    readonly mergeState: Schema.optionalKey<Schema.String>;
+    readonly checkState: Schema.optionalKey<Schema.String>;
+    readonly reviewState: Schema.optionalKey<Schema.String>;
+    readonly reviewHeadCommitSha: Schema.optionalKey<Schema.String>;
+    readonly checkHeadCommitSha: Schema.optionalKey<Schema.String>;
+    readonly snapshotObservedAt: Schema.optionalKey<Schema.String>;
+    readonly reviewObservedAt: Schema.optionalKey<Schema.String>;
+    readonly checkObservedAt: Schema.optionalKey<Schema.String>;
+    readonly reconciliationState: Schema.optionalKey<Schema.Literals<readonly ["current", "required"]>>;
+}>;
+export declare const ChangeRequest: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    /** The Tasks it delivers; none for a taskless Run's, such as a scheduled Sweep's batch. */
+    readonly taskIds: Schema.$Array<Schema.String>;
+    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+    readonly repoBindingId: Schema.String;
+    readonly provider: Schema.Literals<readonly ["github", "gitlab", "forgejo", "gitea", "gitee", "bitbucket", "azure-devops", "generic_git"]>;
+    readonly host: Schema.String;
+    readonly owner: Schema.String;
+    readonly repositoryName: Schema.String;
+    readonly providerRepositoryId: Schema.String;
+    readonly url: Schema.String;
+    readonly externalId: Schema.String;
+    readonly title: Schema.String;
+    readonly sourceBranch: Schema.String;
+    readonly targetBranch: Schema.String;
+    readonly status: Schema.Literals<readonly ["draft", "open", "closed", "merged"]>;
+    readonly draft: Schema.Boolean;
+    readonly providerMetadata: Schema.optionalKey<Schema.Struct<{
+        readonly headCommitSha: Schema.optionalKey<Schema.String>;
+        readonly baseCommitSha: Schema.optionalKey<Schema.String>;
+        readonly bodyDigest: Schema.optionalKey<Schema.String>;
+        readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly mergeable: Schema.optionalKey<Schema.Boolean>;
+        readonly mergeState: Schema.optionalKey<Schema.String>;
+        readonly checkState: Schema.optionalKey<Schema.String>;
+        readonly reviewState: Schema.optionalKey<Schema.String>;
+        readonly reviewHeadCommitSha: Schema.optionalKey<Schema.String>;
+        readonly checkHeadCommitSha: Schema.optionalKey<Schema.String>;
+        readonly snapshotObservedAt: Schema.optionalKey<Schema.String>;
+        readonly reviewObservedAt: Schema.optionalKey<Schema.String>;
+        readonly checkObservedAt: Schema.optionalKey<Schema.String>;
+        readonly reconciliationState: Schema.optionalKey<Schema.Literals<readonly ["current", "required"]>>;
+    }>>;
+    readonly lastObservedAt: Schema.String;
+    readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+    readonly createdByActorId: Schema.String;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>;
+export declare const ChangeRequestList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly teamId: Schema.optionalKey<Schema.String>;
+        /** The Tasks it delivers; none for a taskless Run's, such as a scheduled Sweep's batch. */
+        readonly taskIds: Schema.$Array<Schema.String>;
+        readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+        readonly repoBindingId: Schema.String;
+        readonly provider: Schema.Literals<readonly ["github", "gitlab", "forgejo", "gitea", "gitee", "bitbucket", "azure-devops", "generic_git"]>;
+        readonly host: Schema.String;
+        readonly owner: Schema.String;
+        readonly repositoryName: Schema.String;
+        readonly providerRepositoryId: Schema.String;
+        readonly url: Schema.String;
+        readonly externalId: Schema.String;
+        readonly title: Schema.String;
+        readonly sourceBranch: Schema.String;
+        readonly targetBranch: Schema.String;
+        readonly status: Schema.Literals<readonly ["draft", "open", "closed", "merged"]>;
+        readonly draft: Schema.Boolean;
+        readonly providerMetadata: Schema.optionalKey<Schema.Struct<{
+            readonly headCommitSha: Schema.optionalKey<Schema.String>;
+            readonly baseCommitSha: Schema.optionalKey<Schema.String>;
+            readonly bodyDigest: Schema.optionalKey<Schema.String>;
+            readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
+            readonly mergeable: Schema.optionalKey<Schema.Boolean>;
+            readonly mergeState: Schema.optionalKey<Schema.String>;
+            readonly checkState: Schema.optionalKey<Schema.String>;
+            readonly reviewState: Schema.optionalKey<Schema.String>;
+            readonly reviewHeadCommitSha: Schema.optionalKey<Schema.String>;
+            readonly checkHeadCommitSha: Schema.optionalKey<Schema.String>;
+            readonly snapshotObservedAt: Schema.optionalKey<Schema.String>;
+            readonly reviewObservedAt: Schema.optionalKey<Schema.String>;
+            readonly checkObservedAt: Schema.optionalKey<Schema.String>;
+            readonly reconciliationState: Schema.optionalKey<Schema.Literals<readonly ["current", "required"]>>;
+        }>>;
+        readonly lastObservedAt: Schema.String;
+        readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly createdByActorId: Schema.String;
+        readonly createdAt: Schema.String;
+        readonly updatedAt: Schema.String;
+    }>>;
+    readonly nextCursor: Schema.optionalKey<Schema.String>;
+}>;
+export declare const ChangeRequestDetail: Schema.Struct<{
+    readonly changeRequest: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly teamId: Schema.optionalKey<Schema.String>;
+        /** The Tasks it delivers; none for a taskless Run's, such as a scheduled Sweep's batch. */
+        readonly taskIds: Schema.$Array<Schema.String>;
+        readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+        readonly repoBindingId: Schema.String;
+        readonly provider: Schema.Literals<readonly ["github", "gitlab", "forgejo", "gitea", "gitee", "bitbucket", "azure-devops", "generic_git"]>;
+        readonly host: Schema.String;
+        readonly owner: Schema.String;
+        readonly repositoryName: Schema.String;
+        readonly providerRepositoryId: Schema.String;
+        readonly url: Schema.String;
+        readonly externalId: Schema.String;
+        readonly title: Schema.String;
+        readonly sourceBranch: Schema.String;
+        readonly targetBranch: Schema.String;
+        readonly status: Schema.Literals<readonly ["draft", "open", "closed", "merged"]>;
+        readonly draft: Schema.Boolean;
+        readonly providerMetadata: Schema.optionalKey<Schema.Struct<{
+            readonly headCommitSha: Schema.optionalKey<Schema.String>;
+            readonly baseCommitSha: Schema.optionalKey<Schema.String>;
+            readonly bodyDigest: Schema.optionalKey<Schema.String>;
+            readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
+            readonly mergeable: Schema.optionalKey<Schema.Boolean>;
+            readonly mergeState: Schema.optionalKey<Schema.String>;
+            readonly checkState: Schema.optionalKey<Schema.String>;
+            readonly reviewState: Schema.optionalKey<Schema.String>;
+            readonly reviewHeadCommitSha: Schema.optionalKey<Schema.String>;
+            readonly checkHeadCommitSha: Schema.optionalKey<Schema.String>;
+            readonly snapshotObservedAt: Schema.optionalKey<Schema.String>;
+            readonly reviewObservedAt: Schema.optionalKey<Schema.String>;
+            readonly checkObservedAt: Schema.optionalKey<Schema.String>;
+            readonly reconciliationState: Schema.optionalKey<Schema.Literals<readonly ["current", "required"]>>;
+        }>>;
+        readonly lastObservedAt: Schema.String;
+        readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly createdByActorId: Schema.String;
+        readonly createdAt: Schema.String;
+        readonly updatedAt: Schema.String;
+    }>;
+}>;
+/** A file a ChangeRequest changes, as its forge reports it; Kitman stores none of it. */
+export declare const ChangeRequestChangedFile: Schema.Struct<{
+    readonly path: Schema.String;
+    readonly previousPath: Schema.optionalKey<Schema.String>;
+    readonly status: Schema.Literals<readonly ["added", "modified", "removed", "renamed", "copied", "changed"]>;
+    readonly additions: Schema.optionalKey<Schema.Int>;
+    readonly deletions: Schema.optionalKey<Schema.Int>;
+    readonly patch: Schema.optionalKey<Schema.String>;
+    /** `omitted` when the forge sent no patch, `truncated` when Kitman cut it short. */
+    readonly patchState: Schema.Literals<readonly ["shown", "omitted", "truncated", "binary"]>;
+}>;
+export declare const ChangeRequestFiles: Schema.Struct<{
+    /** The forge's name, for "Open on GitLab". */
+    readonly forge: Schema.String;
+    readonly url: Schema.String;
+    /** Absent when the forge cannot list them or the read failed: the list is on the forge. */
+    readonly files: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly previousPath: Schema.optionalKey<Schema.String>;
+        readonly status: Schema.Literals<readonly ["added", "modified", "removed", "renamed", "copied", "changed"]>;
+        readonly additions: Schema.optionalKey<Schema.Int>;
+        readonly deletions: Schema.optionalKey<Schema.Int>;
+        readonly patch: Schema.optionalKey<Schema.String>;
+        /** `omitted` when the forge sent no patch, `truncated` when Kitman cut it short. */
+        readonly patchState: Schema.Literals<readonly ["shown", "omitted", "truncated", "binary"]>;
+    }>>>;
+    /** The ChangeRequest changes more files than Kitman lists. */
+    readonly more: Schema.optionalKey<Schema.Boolean>;
+}>;
+export type ChangeRequestChangedFile = (typeof ChangeRequestChangedFile)['Type'];
+export type ChangeRequestFiles = (typeof ChangeRequestFiles)['Type'];
+/** A Task to link a ChangeRequest to, which also lifts that Task's suppression. */
+export declare const ChangeRequestTaskLink: Schema.Struct<{
+    readonly taskId: Schema.String;
+}>;
+export declare const ChangeRequestReadiness: Schema.Struct<{
+    readonly state: Schema.Literals<readonly ["ready", "blocked", "stale"]>;
+    readonly headCommitSha: Schema.optionalKey<Schema.String>;
+    readonly observedAt: Schema.String;
+    readonly refreshDueAt: Schema.String;
+    readonly freshness: Schema.Literals<readonly ["current", "stale"]>;
+    readonly permissionState: Schema.Literals<readonly ["ready", "missing"]>;
+    readonly providerUrl: Schema.String;
+    readonly gates: Schema.Struct<{
+        readonly providerProtection: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly providerChecks: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly providerReview: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly taskAcceptance: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly verification: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly independence: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly authority: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly capability: Schema.Struct<{
+            readonly ready: Schema.Boolean;
+            readonly reason: Schema.optionalKey<Schema.String>;
+        }>;
+    }>;
+    readonly reasons: Schema.$Array<Schema.String>;
+}>;
+type ChangeRequestReadinessInput = {
+    readonly changeRequest: Pick<ChangeRequest, 'status' | 'draft' | 'url' | 'lastObservedAt' | 'createdByActorType' | 'createdByActorId' | 'providerMetadata'>;
+    /** Each delivered Task's acceptance criteria; none when it delivers no Task. */
+    readonly taskAcceptanceCriteria: readonly (readonly string[])[];
+    readonly verificationCommands: readonly string[];
+    readonly reviews: readonly Pick<ChangeRequestReviewReadinessEvidence, 'outcome' | 'reviewerActorType' | 'reviewerActorId' | 'headCommitSha'>[];
+    readonly connection: {
+        readonly connected: boolean;
+        readonly credentialConfigured: boolean;
+        readonly capabilities: readonly string[];
+    };
+    /** The latest pipeline result reported to Kitman for the head, when the pipeline runs outside the forge. */
+    readonly reportedPipeline?: {
+        readonly head: string;
+        readonly status: 'success' | 'failed' | 'canceled';
+        readonly reportedBy?: {
+            readonly actorType: string;
+            readonly actorId: string;
+        };
+    };
+    readonly now: Date;
+    readonly maxAgeSeconds?: number;
+};
+type ChangeRequestReviewReadinessEvidence = {
+    readonly outcome: string;
+    readonly reviewerActorType?: ActorType;
+    readonly reviewerActorId?: string;
+    readonly headCommitSha?: string;
+};
+/** The actor id Kitman records a Run's own writes under, such as the ChangeRequest it opens or a review it approves. */
+export declare const runActorId: (runId: string) => string;
+/**
+ * Whether a review approves `head` independently of whoever opened the ChangeRequest: a person's, or a Run's recorded
+ * under `runActorId` once Kitman has checked it did not write the change. Any other agent, including a delegated tool
+ * such as a Step's Code Mode, cannot be tied to the Run it works for, so it may be the author.
+ */
+export declare function isIndependentApproval(review: ChangeRequestReviewReadinessEvidence, changeRequest: Pick<ChangeRequest, 'createdByActorType' | 'createdByActorId'>, head: string | undefined): boolean;
+/** The `checkState` a refresh records when the forge ran no checks for the head. */
+export declare const noForgeChecks = "none";
+export declare function evaluateChangeRequestReadiness(input: ChangeRequestReadinessInput): ChangeRequestReadiness;
+export type ChangeRequestStatus = (typeof ChangeRequestStatus)['Type'];
+export type ChangeRequestProviderRef = (typeof ChangeRequestProviderRef)['Type'];
+export type ChangeRequestProviderMetadata = (typeof ChangeRequestProviderMetadata)['Type'];
+export type ChangeRequest = (typeof ChangeRequest)['Type'];
+export type ChangeRequestList = (typeof ChangeRequestList)['Type'];
+export type ChangeRequestDetail = (typeof ChangeRequestDetail)['Type'];
+export type ChangeRequestTaskLink = (typeof ChangeRequestTaskLink)['Type'];
+export type ChangeRequestReadiness = (typeof ChangeRequestReadiness)['Type'];
+export {};

package/types/packages/core/src/connection.d.ts

@@ -0,0 +1,33 @@
+import * as Schema from 'effect/Schema';
+export declare const Connection: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly owner: Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>, Schema.Literal<"runner">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+        readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+        readonly runnerId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly provider: Schema.String;
+    readonly scopes: Schema.$Array<Schema.String>;
+    readonly allowedEvents: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly schema: Schema.Struct<{
+            readonly kind: Schema.Literal<"typebox_ref">;
+            readonly name: Schema.String;
+            readonly version: Schema.String;
+            readonly sha256: Schema.String;
+        }>;
+    }>>;
+    readonly secretRefs: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.Literal<"secret_ref">;
+        readonly ref: Schema.String;
+    }>>;
+    readonly health: Schema.Literals<readonly ["healthy", "degraded", "unavailable"]>;
+    readonly deliveryCursor: Schema.optionalKey<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>;
+export type Connection = (typeof Connection)['Type'];

package/types/packages/core/src/context-feedback.d.ts

@@ -0,0 +1,89 @@
+import * as Schema from 'effect/Schema';
+export declare const ContextRelevanceFeedbackProposalTargetTypes: readonly ['memory', 'kit', 'decision', 'agent_environment_policy', 'team_context', 'context_relevance'];
+export declare const ContextRelevanceFeedbackKind: Schema.Literals<readonly ["missing_context", "irrelevant_context", "stale_context", "useful_context"]>;
+export declare const ContextRelevanceFeedbackCreate: Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["missing_context", "irrelevant_context", "stale_context", "useful_context"]>;
+    readonly contextPackId: Schema.String;
+    readonly sessionId: Schema.optionalKey<Schema.String>;
+    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+    readonly retrievalRefKind: Schema.optionalKey<Schema.String>;
+    readonly retrievalRefId: Schema.optionalKey<Schema.String>;
+    readonly content: Schema.String;
+    readonly evidence: Schema.optionalKey<Schema.String>;
+    readonly proposalCandidate: Schema.optionalKey<Schema.Struct<{
+        readonly targetType: Schema.Literals<readonly ["memory", "kit", "decision", "agent_environment_policy", "team_context", "context_relevance"]>;
+        readonly title: Schema.String;
+        readonly summary: Schema.String;
+        readonly suggestedChange: Schema.String;
+        readonly riskLevel: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high"]>>;
+    }>>;
+}>;
+export declare const ContextRelevanceFeedback: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly taskId: Schema.String;
+    readonly contextPackId: Schema.String;
+    readonly sessionId: Schema.optionalKey<Schema.String>;
+    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+    readonly kind: Schema.Literals<readonly ["missing_context", "irrelevant_context", "stale_context", "useful_context"]>;
+    readonly retrievalRefKind: Schema.optionalKey<Schema.String>;
+    readonly retrievalRefId: Schema.optionalKey<Schema.String>;
+    readonly content: Schema.String;
+    readonly evidence: Schema.optionalKey<Schema.String>;
+    readonly generatedProposalId: Schema.optionalKey<Schema.String>;
+    readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+    readonly createdByActorId: Schema.String;
+    readonly createdAt: Schema.String;
+}>;
+export declare const ContextRelevanceFeedbackCreateResult: Schema.Struct<{
+    readonly feedback: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly teamId: Schema.optionalKey<Schema.String>;
+        readonly taskId: Schema.String;
+        readonly contextPackId: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+        readonly kind: Schema.Literals<readonly ["missing_context", "irrelevant_context", "stale_context", "useful_context"]>;
+        readonly retrievalRefKind: Schema.optionalKey<Schema.String>;
+        readonly retrievalRefId: Schema.optionalKey<Schema.String>;
+        readonly content: Schema.String;
+        readonly evidence: Schema.optionalKey<Schema.String>;
+        readonly generatedProposalId: Schema.optionalKey<Schema.String>;
+        readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly createdByActorId: Schema.String;
+        readonly createdAt: Schema.String;
+    }>;
+    readonly proposal: Schema.optionalKey<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly teamId: Schema.optionalKey<Schema.String>;
+        readonly taskId: Schema.optionalKey<Schema.String>;
+        readonly target: Schema.Struct<{
+            readonly type: Schema.Literals<readonly ["memory", "kit", "agent_environment_policy", "decision", "task", "team_context", "context_relevance", "kit_source", "kit_version", "kit_installation", "kit_activation", "kit_trust_policy"]>;
+            readonly id: Schema.optionalKey<Schema.String>;
+            readonly scopeType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"kit">]>>;
+            readonly scopeId: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly title: Schema.String;
+        readonly summary: Schema.String;
+        readonly status: Schema.Literals<readonly ["proposed", "in_review", "approved", "rejected", "applied", "reverted", "superseded", "canceled"]>;
+        readonly riskLevel: Schema.Literals<readonly ["low", "medium", "high"]>;
+        readonly approvalPolicy: Schema.Struct<{
+            readonly mode: Schema.Literals<readonly ["auto_approve_low_risk", "require_other_team_member", "require_workspace_owner_or_admin"]>;
+            readonly requireDifferentApprover: Schema.optionalKey<Schema.Boolean>;
+            readonly autonomousAgentApprovalAllowed: Schema.Literal<false>;
+            readonly deniedViolationCodes: Schema.$Array<Schema.Literals<readonly ["autonomous_self_approval", "self_capability_escalation", "missing_required_approval", "unsafe_payload", "target_conflict"]>>;
+        }>;
+        readonly proposedByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly proposedByActorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+        readonly createdAt: Schema.String;
+        readonly updatedAt: Schema.String;
+    }>>;
+}>;
+export type ContextRelevanceFeedbackKind = (typeof ContextRelevanceFeedbackKind)['Type'];
+export type ContextRelevanceFeedbackCreate = (typeof ContextRelevanceFeedbackCreate)['Type'];
+export type ContextRelevanceFeedback = (typeof ContextRelevanceFeedback)['Type'];
+export type ContextRelevanceFeedbackCreateResult = (typeof ContextRelevanceFeedbackCreateResult)['Type'];

package/types/packages/core/src/data-lifecycle.d.ts

@@ -0,0 +1,195 @@
+import * as Schema from 'effect/Schema';
+declare const DataLifecycleSubjectKinds: readonly ['workspace', 'team', 'task', 'runner', 'runner_replica'];
+export type DataLifecycleSubjectKind = (typeof DataLifecycleSubjectKinds)[number];
+export declare const DataLifecycleStates: readonly ['active', 'requested', 'draining', 'export_evaluated', 'erased', 'tombstoned', 'blocked_by_hold', 'residue_unknown', 'rejected', 'canceled'];
+export type DataLifecycleState = (typeof DataLifecycleStates)[number];
+declare const DataLifecycleDispositions: readonly ['retain', 'erase', 'tombstone'];
+export type DataLifecycleDisposition = (typeof DataLifecycleDispositions)[number];
+declare const DataLifecycleHoldStatuses: readonly ['active', 'released', 'superseded'];
+export type DataLifecycleHoldStatus = (typeof DataLifecycleHoldStatuses)[number];
+declare const DataLifecycleCaseHoldStatuses: readonly ['none', 'active', 'released'];
+export type DataLifecycleCaseHoldStatus = (typeof DataLifecycleCaseHoldStatuses)[number];
+declare const DataLifecycleResidueDispositions: readonly ['deleted', 'quarantined', 'retained_until', 'unknown'];
+export type DataLifecycleResidueDisposition = (typeof DataLifecycleResidueDispositions)[number];
+export declare const DataLifecycleSubjectKind: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"runner">, Schema.Literal<"runner_replica">]>;
+export declare const DataLifecycleState: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"requested">, Schema.Literal<"draining">, Schema.Literal<"export_evaluated">, Schema.Literal<"erased">, Schema.Literal<"tombstoned">, Schema.Literal<"blocked_by_hold">, Schema.Literal<"residue_unknown">, Schema.Literal<"rejected">, Schema.Literal<"canceled">]>;
+export declare const DataLifecycleDisposition: Schema.Union<readonly [Schema.Literal<"retain">, Schema.Literal<"erase">, Schema.Literal<"tombstone">]>;
+export declare const DataLifecycleHoldStatus: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"released">, Schema.Literal<"superseded">]>;
+export declare const DataLifecycleCaseHoldStatus: Schema.Union<readonly [Schema.Literal<"none">, Schema.Literal<"active">, Schema.Literal<"released">]>;
+export declare const DataLifecycleResidueDisposition: Schema.Union<readonly [Schema.Literal<"deleted">, Schema.Literal<"quarantined">, Schema.Literal<"retained_until">, Schema.Literal<"unknown">]>;
+export declare const DataLifecycleCase: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"data-lifecycle.v1">;
+    readonly id: Schema.String;
+    readonly subjectKind: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"runner">, Schema.Literal<"runner_replica">]>;
+    readonly subjectId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly requestedDisposition: Schema.Union<readonly [Schema.Literal<"retain">, Schema.Literal<"erase">, Schema.Literal<"tombstone">]>;
+    readonly policyDigest: Schema.String;
+    readonly state: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"requested">, Schema.Literal<"draining">, Schema.Literal<"export_evaluated">, Schema.Literal<"erased">, Schema.Literal<"tombstoned">, Schema.Literal<"blocked_by_hold">, Schema.Literal<"residue_unknown">, Schema.Literal<"rejected">, Schema.Literal<"canceled">]>;
+    readonly holdStatus: Schema.Union<readonly [Schema.Literal<"none">, Schema.Literal<"active">, Schema.Literal<"released">]>;
+    readonly resourceVersion: Schema.Int;
+    readonly containmentVersion: Schema.Int;
+    readonly exportManifestId: Schema.optionalKey<Schema.String>;
+    readonly erasureId: Schema.optionalKey<Schema.String>;
+    readonly tombstoneId: Schema.optionalKey<Schema.String>;
+    readonly residueUnknown: Schema.Boolean;
+    readonly owner: Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>;
+export type DataLifecycleCase = (typeof DataLifecycleCase)['Type'];
+export declare const DataLifecycleRequest: Schema.Struct<{
+    readonly subjectKind: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"runner">, Schema.Literal<"runner_replica">]>;
+    readonly subjectId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly requestedDisposition: Schema.Union<readonly [Schema.Literal<"retain">, Schema.Literal<"erase">, Schema.Literal<"tombstone">]>;
+    readonly policyDigest: Schema.String;
+    readonly reasonClass: Schema.String;
+    readonly expectedResourceVersion: Schema.optionalKey<Schema.Int>;
+}>;
+export type DataLifecycleRequest = (typeof DataLifecycleRequest)['Type'];
+export declare const DataLifecycleHoldRequest: Schema.Struct<{
+    readonly scopeKind: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"runner">, Schema.Literal<"runner_replica">]>;
+    readonly scopeRef: Schema.String;
+    readonly categories: Schema.$Array<Schema.String>;
+    readonly authorityRef: Schema.String;
+    readonly reasonClass: Schema.String;
+    readonly reviewAt: Schema.String;
+    readonly policyDigest: Schema.String;
+}>;
+export type DataLifecycleHoldRequest = (typeof DataLifecycleHoldRequest)['Type'];
+export declare const DataLifecycleHold: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"data-lifecycle.v1">;
+    readonly id: Schema.String;
+    readonly caseId: Schema.String;
+    readonly scopeKind: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"runner">, Schema.Literal<"runner_replica">]>;
+    readonly scopeRef: Schema.String;
+    readonly categories: Schema.$Array<Schema.String>;
+    readonly authorityRef: Schema.String;
+    readonly reasonClass: Schema.String;
+    readonly openedAt: Schema.String;
+    readonly reviewAt: Schema.String;
+    readonly releasedAt: Schema.optionalKey<Schema.String>;
+    readonly policyDigest: Schema.String;
+    readonly actor: Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"released">, Schema.Literal<"superseded">]>;
+}>;
+export type DataLifecycleHold = (typeof DataLifecycleHold)['Type'];
+export declare const DataLifecycleExportManifest: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"data-lifecycle.v1">;
+    readonly id: Schema.String;
+    readonly caseId: Schema.String;
+    readonly subjectKind: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"runner">, Schema.Literal<"runner_replica">]>;
+    readonly subjectId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly policyDigest: Schema.String;
+    readonly memberDigests: Schema.$Array<Schema.String>;
+    readonly omissions: Schema.$Array<Schema.Struct<{
+        readonly category: Schema.String;
+        readonly reason: Schema.Union<readonly [Schema.Literal<"authorization">, Schema.Literal<"redaction">, Schema.Literal<"retention">, Schema.Literal<"legal_hold">, Schema.Literal<"raw_local">, Schema.Literal<"provider_owned">]>;
+    }>>;
+    readonly manifestDigest: Schema.String;
+    readonly createdAt: Schema.String;
+    readonly actor: Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+    }>;
+}>;
+export type DataLifecycleExportManifest = (typeof DataLifecycleExportManifest)['Type'];
+export declare const DataLifecycleExportRequest: Schema.Struct<{
+    readonly memberDigests: Schema.$Array<Schema.String>;
+    readonly omissions: Schema.$Array<Schema.Struct<{
+        readonly category: Schema.String;
+        readonly reason: Schema.Union<readonly [Schema.Literal<"authorization">, Schema.Literal<"redaction">, Schema.Literal<"retention">, Schema.Literal<"legal_hold">, Schema.Literal<"raw_local">, Schema.Literal<"provider_owned">]>;
+    }>>;
+}>;
+export type DataLifecycleExportRequest = (typeof DataLifecycleExportRequest)['Type'];
+export declare const DataLifecycleErasure: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly caseId: Schema.String;
+    readonly status: Schema.Union<readonly [Schema.Literal<"requested">, Schema.Literal<"blocked_by_hold">, Schema.Literal<"approved">, Schema.Literal<"completed">, Schema.Literal<"provider_owned_nonclaim">]>;
+    readonly reasonClass: Schema.String;
+    readonly policyDigest: Schema.String;
+    readonly holdSummary: Schema.String;
+    readonly finalRedactionEpoch: Schema.Int;
+    readonly tombstoneId: Schema.optionalKey<Schema.String>;
+    readonly providerOwnedNonclaim: Schema.Boolean;
+    readonly actor: Schema.optionalKey<Schema.Struct<{
+        readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly actorId: Schema.String;
+        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+    }>>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>;
+export type DataLifecycleErasure = (typeof DataLifecycleErasure)['Type'];
+export declare const DataLifecycleResidueResource: Schema.Struct<{
+    readonly resourceKind: Schema.String;
+    readonly resourceRef: Schema.String;
+    readonly disposition: Schema.Union<readonly [Schema.Literal<"deleted">, Schema.Literal<"quarantined">, Schema.Literal<"retained_until">, Schema.Literal<"unknown">]>;
+    readonly retainedUntil: Schema.optionalKey<Schema.String>;
+    readonly ownerRef: Schema.optionalKey<Schema.String>;
+    readonly policyDigest: Schema.String;
+    readonly nextCheckAt: Schema.optionalKey<Schema.String>;
+    readonly receiptDigest: Schema.optionalKey<Schema.String>;
+}>;
+export type DataLifecycleResidueResource = (typeof DataLifecycleResidueResource)['Type'];
+export declare const DataLifecycleResidueRequest: Schema.Struct<{
+    readonly resources: Schema.$Array<Schema.Struct<{
+        readonly resourceKind: Schema.String;
+        readonly resourceRef: Schema.String;
+        readonly disposition: Schema.Union<readonly [Schema.Literal<"deleted">, Schema.Literal<"quarantined">, Schema.Literal<"retained_until">, Schema.Literal<"unknown">]>;
+        readonly retainedUntil: Schema.optionalKey<Schema.String>;
+        readonly ownerRef: Schema.optionalKey<Schema.String>;
+        readonly policyDigest: Schema.String;
+        readonly nextCheckAt: Schema.optionalKey<Schema.String>;
+        readonly receiptDigest: Schema.optionalKey<Schema.String>;
+    }>>;
+}>;
+export type DataLifecycleResidueRequest = (typeof DataLifecycleResidueRequest)['Type'];
+export declare const DataLifecycleTombstone: Schema.Struct<{
+    readonly contractVersion: Schema.Literal<"data-lifecycle.v1">;
+    readonly id: Schema.String;
+    readonly caseId: Schema.String;
+    readonly subjectKind: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"team">, Schema.Literal<"task">, Schema.Literal<"runner">, Schema.Literal<"runner_replica">]>;
+    readonly subjectId: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly taskId: Schema.optionalKey<Schema.String>;
+    readonly priorSafeDigest: Schema.optionalKey<Schema.String>;
+    readonly finalRedactionEpoch: Schema.Int;
+    readonly disposition: Schema.Union<readonly [Schema.Literal<"retain">, Schema.Literal<"erase">, Schema.Literal<"tombstone">]>;
+    readonly erasureReasonClass: Schema.String;
+    readonly retentionPolicyDigest: Schema.String;
+    readonly holdSummary: Schema.String;
+    readonly residueDisposition: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"deleted">, Schema.Literal<"quarantined">, Schema.Literal<"retained_until">, Schema.Literal<"unknown">]>>;
+    readonly createdAt: Schema.String;
+    readonly eventRef: Schema.String;
+}>;
+export type DataLifecycleTombstone = (typeof DataLifecycleTombstone)['Type'];
+export declare function isDataLifecycleTransitionAllowed(from: DataLifecycleState, to: DataLifecycleState): boolean;
+export declare function assertDataLifecycleTransition(from: DataLifecycleState, to: DataLifecycleState): void;
+export declare function isDataLifecycleSecurityContained(state: DataLifecycleState): boolean;
+export declare function lifecycleRequestDigest(input: {
+    readonly subjectKind: DataLifecycleSubjectKind;
+    readonly subjectId: string;
+    readonly workspaceId: string;
+    readonly teamId?: string;
+    readonly requestedDisposition: DataLifecycleDisposition;
+    readonly policyDigest: string;
+    readonly reasonClass: string;
+}): string;
+export declare function assertSafeDataLifecycleText(value: string, path?: string): void;
+export declare function assertSafeDataLifecycleMetadata<ValueType>(value: ValueType, path?: string): void;
+export {};