@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/agent-capacity/contracts/capacity/workdays/workday-records.d.ts

@@ -0,0 +1,188 @@
+/** Portable durable records shared by workday control-plane and operator consumers. */
+import type { WorkdayAgentSelection } from '../../../workday.js';
+import type { AgentWorkExecutionMode } from '../../support/execution-mode.js';
+export type CapacityWorkdayRunStatus = 'queued' | 'running' | 'completed' | 'cancelled' | 'failed' | 'degraded';
+export type CapacityWorkdayEventStatus = 'recorded' | 'active' | 'completed' | 'warning' | 'error' | 'failed';
+export type CapacityWorkdayDemandSource = 'objective' | 'question' | 'proposal' | 'decision-review' | 'knowledge-gap' | 'release-readiness' | 'idle-intent' | 'planning-input' | 'capacity-plan' | 'assignment-completion' | 'assignment-blockage' | 'workday-summary' | 'handoff' | 'research-workflow';
+export type CapacityWorkdayDemandStatus = 'pending' | 'claimed' | 'admitted' | 'completed' | 'blocked' | 'cancelled' | 'superseded';
+export type CapacityWorkdayParticipationCycleStatus = 'open' | 'covered' | 'closed';
+export type CapacityWorkdayParticipationEntryStatus = 'pending' | 'assigned' | 'completed' | 'excluded' | 'blocked';
+export interface CapacityWorkdayRunRecord {
+    id: string;
+    teamId: string;
+    capacityProviderId: string | null;
+    scenarioId: string;
+    status: CapacityWorkdayRunStatus;
+    environment: string;
+    executionMode?: AgentWorkExecutionMode;
+    executionKind?: import('../communication/communication-records.js').CapacityExecutionKind;
+    triggerKind?: import('../communication/communication-records.js').CapacityTriggerKind;
+    hidden?: boolean;
+    requestedById: string | null;
+    parameters: Record<string, unknown>;
+    summary: Record<string, unknown>;
+    metrics: Record<string, unknown>;
+    expected: Record<string, unknown>;
+    actual: Record<string, unknown>;
+    reportRefs: Record<string, unknown>;
+    error: Record<string, unknown>;
+    startedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CapacityWorkdayEventRecord {
+    id: string;
+    runId: string;
+    teamId: string;
+    projectId: string | null;
+    workdayId: string | null;
+    assignmentId: string | null;
+    modeRunId: string | null;
+    eventIndex: number;
+    eventType: string;
+    status: CapacityWorkdayEventStatus;
+    title: string | null;
+    message: string | null;
+    parameters: Record<string, unknown>;
+    context: Record<string, unknown>;
+    refs: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+}
+export type AgentActivityEventSeverity = 'debug' | 'info' | 'warning' | 'error';
+/** Compact, ordered workday activity. Full model and tool payloads are retrieved through transcriptRef. */
+export interface AgentActivityEvent {
+    id: string;
+    sequence: number;
+    sourceEventId: string;
+    timestamp: string;
+    teamId: string;
+    projectId: string | null;
+    workdayId: string;
+    assignmentId: string | null;
+    modeRunId: string | null;
+    executionRunId: string | null;
+    agentId: string | null;
+    agentClassId: string | null;
+    activityType: string | null;
+    handlerId: string | null;
+    capacityProviderId: string | null;
+    providerManagerId: string | null;
+    runnerId: string | null;
+    executionProviderId: string | null;
+    eventType: string;
+    severity: AgentActivityEventSeverity;
+    summary: string;
+    transcriptRef: string | null;
+    artifactRefs: Record<string, unknown>[];
+    contextPackDigest: string | null;
+    usageDelta: Record<string, unknown>;
+    durationMs: number | null;
+    errorCategory: string | null;
+    recoveryState: string | null;
+    redactionStatus: string;
+    payloadDigest: string;
+}
+export interface ProviderRuntimeEventInput {
+    id: string;
+    eventType: `provider.${string}`;
+    status: 'recorded' | 'active' | 'completed' | 'warning' | 'error' | 'failed';
+    component: 'provider-manager' | 'provider-runner' | 'lease' | 'execution-provider' | 'recovery';
+    message: string;
+    createdAt?: string;
+    context?: Record<string, unknown>;
+    refs?: Record<string, unknown>;
+    metrics?: Record<string, unknown>;
+}
+export interface CapacityWorkdayScheduleRecord {
+    id: string;
+    teamId: string;
+    projectIds: string[];
+    status: 'active' | 'paused' | 'completed' | 'failed';
+    purpose: string;
+    capacityProviderId: string;
+    agentSelection: WorkdayAgentSelection;
+    cadenceSeconds: number;
+    durationSeconds: number;
+    maxActiveAssignments: number;
+    availableSeconds: number;
+    timePolicy: import('../../support/time-capacity.js').WorkdayTimePolicy;
+    planningOnly: boolean;
+    executionMode?: AgentWorkExecutionMode;
+    publicationPolicy: {
+        bookIds: string[];
+        target: 'staging' | 'production';
+        cohortMode: 'accepted';
+        requireTechnicalReview: boolean;
+        requireAudienceReview: boolean;
+        requireGraphReviewWhenStructural: boolean;
+        simulatedHumanApproval: boolean;
+    };
+    lastRunId: string | null;
+    nextRunAt: string;
+    stateVersion: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CapacityWorkdayDemandRecord {
+    id: string;
+    teamId: string;
+    projectId: string;
+    workdayRunId: string;
+    workdayId: string;
+    sourceType: CapacityWorkdayDemandSource;
+    sourceId: string;
+    mode: 'planning' | 'acting';
+    executionMode?: AgentWorkExecutionMode;
+    projectAgentClassId: string;
+    agentId: string | null;
+    handlerId: string;
+    activityType: string;
+    decisionId: string | null;
+    capacityPlanId: string | null;
+    status: CapacityWorkdayDemandStatus;
+    priority: number;
+    requestedSeconds: number;
+    idempotencyKey: string;
+    claimToken: string | null;
+    assignmentId: string | null;
+    payload: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    availableAt: string;
+    claimedAt: string | null;
+    admittedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CapacityWorkdayParticipationCycleRecord {
+    id: string;
+    teamId: string;
+    projectId: string;
+    workdayRunId: string;
+    cycleNumber: number;
+    status: CapacityWorkdayParticipationCycleStatus;
+    openedAt: string;
+    coveredAt: string | null;
+    closedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CapacityWorkdayParticipationEntryRecord {
+    id: string;
+    cycleId: string;
+    teamId: string;
+    projectId: string;
+    workdayRunId: string;
+    agentId: string;
+    projectAgentClassId: string;
+    status: CapacityWorkdayParticipationEntryStatus;
+    reasonCode: string | null;
+    demandId: string | null;
+    assignmentId: string | null;
+    coveredAt: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/agent-capacity/contracts/configuration/configuration.d.ts

@@ -0,0 +1,11 @@
+export declare const CAPACITY_CONFIGURATION_FAMILIES: readonly ["provider-manifest", "provider-offer", "capacity-grant", "allocation-set", "project-agent-class", "activity-profile"];
+export type CapacityConfigurationFamily = (typeof CAPACITY_CONFIGURATION_FAMILIES)[number];
+export interface CapacityConfigurationDescriptor {
+    id: CapacityConfigurationFamily;
+    ownerPackage: '@treeseed/sdk';
+    format: 'yaml' | 'mdx-frontmatter';
+    schemaId: string;
+    validator: string;
+    runtimeOwner: '@treeseed/agent' | '@treeseed/api';
+}
+export declare const CAPACITY_CONFIGURATION_DESCRIPTORS: readonly CapacityConfigurationDescriptor[];

package/dist/agent-capacity/contracts/configuration/configuration.js

@@ -0,0 +1,20 @@
+const CAPACITY_CONFIGURATION_FAMILIES = [
+  "provider-manifest",
+  "provider-offer",
+  "capacity-grant",
+  "allocation-set",
+  "project-agent-class",
+  "activity-profile"
+];
+const CAPACITY_CONFIGURATION_DESCRIPTORS = [
+  { id: "provider-manifest", ownerPackage: "@treeseed/sdk", format: "yaml", schemaId: "treeseed.capacity-provider/v2", validator: "validateCapacityProviderManifestV2", runtimeOwner: "@treeseed/agent" },
+  { id: "provider-offer", ownerPackage: "@treeseed/sdk", format: "yaml", schemaId: "treeseed.provider-supply-offer/v1", validator: "validateProviderSupplyOffer", runtimeOwner: "@treeseed/agent" },
+  { id: "capacity-grant", ownerPackage: "@treeseed/sdk", format: "yaml", schemaId: "treeseed.capacity-grant/v2", validator: "validateCapacityGrantV2", runtimeOwner: "@treeseed/api" },
+  { id: "allocation-set", ownerPackage: "@treeseed/sdk", format: "yaml", schemaId: "treeseed.capacity-allocation-set/v2", validator: "validateCapacityAllocationSetV2", runtimeOwner: "@treeseed/api" },
+  { id: "project-agent-class", ownerPackage: "@treeseed/sdk", format: "yaml", schemaId: "treeseed.project-agent-class/v1", validator: "validateProjectAgentClassConfiguration", runtimeOwner: "@treeseed/api" },
+  { id: "activity-profile", ownerPackage: "@treeseed/sdk", format: "mdx-frontmatter", schemaId: "treeseed.agent-activity-profiles/v1", validator: "validateAgentActivityProfilesConfiguration", runtimeOwner: "@treeseed/agent" }
+];
+export {
+  CAPACITY_CONFIGURATION_DESCRIPTORS,
+  CAPACITY_CONFIGURATION_FAMILIES
+};

package/dist/agent-capacity/contracts/operations/research-workflow.d.ts

@@ -0,0 +1,59 @@
+import type { ResearchCitation } from '../support/research-citation.js';
+export declare const RESEARCH_WORKFLOW_STAGES: readonly ["question-decomposition", "source-selection-criteria", "governed-source-search", "independent-source-fetch", "linked-evidence-notes", "claim-synthesis", "citation-review-rejection", "revision", "citation-review-approval", "cited-knowledge-publication", "workday-report"];
+export type ResearchWorkflowStage = (typeof RESEARCH_WORKFLOW_STAGES)[number];
+export type ResearchWorkflowStatus = 'ready' | 'running' | 'completed' | 'blocked' | 'failed';
+export type ResearchWorkflowNodeStatus = 'pending' | 'ready' | 'running' | 'completed' | 'failed';
+export interface ResearchClaim {
+    id: string;
+    text: string;
+    material: boolean;
+    status: 'unsupported' | 'supported' | 'contradicted';
+    citationIds: string[];
+}
+export interface ResearchWorkflowNode {
+    id: string;
+    stage: ResearchWorkflowStage;
+    role: 'researcher' | 'reviewer' | 'technical-writer' | 'reporter';
+    status: ResearchWorkflowNodeStatus;
+    dependsOn: string[];
+    assignmentId?: string | null;
+    artifactRefs: string[];
+    completedAt?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ResearchWorkflowRecord {
+    schemaVersion: 1;
+    id: string;
+    teamId: string;
+    projectId: string;
+    objectiveRef: string;
+    questionRef: string;
+    status: ResearchWorkflowStatus;
+    stateVersion: number;
+    minimumIndependentSources: number;
+    maxRevisionCycles: number;
+    nodes: ResearchWorkflowNode[];
+    citations: ResearchCitation[];
+    claims: ResearchClaim[];
+    reviewerRejectedUnsupportedClaims: boolean;
+    reviewerApprovedRevision: boolean;
+    revisionCount: number;
+    publicationRef?: string | null;
+    reportRef?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ResearchStageCompletion {
+    expectedStateVersion: number;
+    stage: ResearchWorkflowStage;
+    assignmentId: string;
+    artifactRefs: string[];
+    citations?: ResearchCitation[];
+    claims?: ResearchClaim[];
+    reviewOutcome?: 'approved' | 'rejected';
+    reviewReason?: string;
+    publicationRef?: string;
+    reportRef?: string;
+    metadata?: Record<string, unknown>;
+}

package/dist/agent-capacity/contracts/operations/research-workflow.js

@@ -0,0 +1,16 @@
+const RESEARCH_WORKFLOW_STAGES = [
+  "question-decomposition",
+  "source-selection-criteria",
+  "governed-source-search",
+  "independent-source-fetch",
+  "linked-evidence-notes",
+  "claim-synthesis",
+  "citation-review-rejection",
+  "revision",
+  "citation-review-approval",
+  "cited-knowledge-publication",
+  "workday-report"
+];
+export {
+  RESEARCH_WORKFLOW_STAGES
+};

package/dist/agent-capacity/contracts/operations/workflow-promotion.d.ts

@@ -0,0 +1,24 @@
+import type { EngineeringAssignmentGraphRoles } from '../support/decision-work.js';
+export interface EngineeringWorkflowPromotionConfigV1 {
+    schemaVersion: 1;
+    id: string;
+    projectId: string;
+    decisionId: string;
+    objectiveId: string;
+    exactBaseRef: string;
+    roles: EngineeringAssignmentGraphRoles;
+    includeResearch?: boolean;
+    includeArchitecture?: boolean;
+    requireLinkedProposal?: boolean;
+    requireRevisionCycle?: boolean;
+    seconds?: Partial<Record<'research' | 'architecture' | 'test' | 'implementation' | 'verification' | 'review' | 'documentation' | 'release' | 'operations', number>>;
+    metadata?: Record<string, unknown>;
+}
+export interface EngineeringWorkflowPromotionValidation {
+    ok: boolean;
+    diagnostics: Array<{
+        code: string;
+        path: string;
+        message: string;
+    }>;
+}

package/dist/agent-capacity/contracts/projects/agents/project-agent-class.d.ts

@@ -0,0 +1,37 @@
+import type { AgentExecutionMode } from '../../capacity/assignments/assignment-records.js';
+export type ProjectAgentClassStatus = 'active' | 'paused' | 'archived';
+export interface AgentKernelProfile {
+    id?: string;
+    name?: string;
+    defaultMode?: AgentExecutionMode;
+    allowedModes?: AgentExecutionMode[];
+    planningBudgetPercent?: number;
+    actingBudgetPercent?: number;
+    maxConcurrentModeRuns?: number;
+    fallbackMode?: AgentExecutionMode | null;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentKernelPolicy {
+    modeSelection?: Record<string, unknown>;
+    budgetSplit?: Record<string, unknown>;
+    fallback?: Record<string, unknown>;
+    outputValidation?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface ProjectAgentClass {
+    id: string;
+    teamId: string;
+    projectId: string;
+    slug: string;
+    name: string;
+    status: ProjectAgentClassStatus;
+    allowedModes: AgentExecutionMode[];
+    requiredCapabilities: string[];
+    kernelProfile: AgentKernelProfile;
+    kernelPolicy: AgentKernelPolicy;
+    handlerRefs: Record<string, unknown>;
+    outputContracts: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}