@treeseed/sdk 0.10.6 → 0.10.7

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export { createControlPlaneReporter } from './control-plane.ts';
 export { ControlPlaneClient } from './control-plane-client.ts';
 export * from './seeds/index.ts';
 export { CAPACITY_PROVIDER_ENDPOINTS, CAPACITY_PROVIDER_DEPLOYMENT_SERVICE_ROLES, CAPACITY_PROVIDER_ENV_KEYS, CAPACITY_PROVIDER_SCOPES, CapacityProviderApiError, MarketProviderClient, assertCapacityProviderOkEnvelope, assertCapacityProviderPortfolioManifest, assertCapacityProviderRegistrationResponse, buildCapacityProviderAuthHeaders, deployCapacityProviderToManagedMarketHost, deployCapacityProviderToRailway, isCapacityProviderSecretEnvKey, redactCapacityProviderEnv, redactCapacityProviderSecret, renderCapacityProviderSelfHostInstructions, persistCapacityProviderConnectionToTreeseedConfig, resolveCapacityProviderEnvironment, resolveCapacityProviderLaunchEnvironment, } from './capacity-provider.ts';
+export { PLATFORM_OPERATION_ENDPOINTS, PLATFORM_OPERATION_NAMESPACES, PLATFORM_OPERATION_SCOPES, PLATFORM_OPERATION_STATUSES, PLATFORM_OPERATION_TARGETS, PlatformOperationApiError, PlatformRunnerClient, assertPlatformOperation, assertPlatformOperationEvent, assertPlatformOperationOkEnvelope, buildPlatformRunnerAuthHeaders, createPlatformOperationExecutorRegistry, derivePlatformOperationNavigation, isPlatformOperationSuccessful, isPlatformOperationTerminal, pollPlatformOperation, runPlatformOperationOnce, type PlatformOperation, type PlatformOperationEvent, type PlatformOperationNavigationResult, type PlatformOperationPollOptions, type PlatformOperationPollResult, } from './platform-operations.ts';
+export { PLATFORM_CONTENT_COLLECTIONS, PLATFORM_WORK_CONTENT_COLLECTIONS, createPlatformRepositoryClaim, derivePlatformRepositoryKey, executePlatformRepositoryOperation, normalizePlatformContentInput, normalizePlatformRelationArray, platformContentRelationPolicy, resolvePlatformRepositoryWorkspacePath, slugifyPlatformContent, type PlatformContentCollection, type PlatformRepositoryClaim, type PlatformRepositoryClaimInput, type PlatformRepositoryDescriptor, type PlatformRepositoryOperationInput, type PlatformRepositoryOperationOptions, type PlatformRepositoryOperationResult, type PlatformRepositoryPathPolicy, type PlatformRepositoryVerificationCommand, type PlatformRepositoryVerificationResult, type NormalizedPlatformContentInput, } from './operations/repository-operations.ts';
 export { DEFAULT_EXECUTION_PROFILE_ID, DEFAULT_EXECUTION_PROFILES, DEFAULT_TASK_ADMISSION_POLICY, buildTaskEstimateProfileFromActuals, computeWorkdayBudgetEnvelope, decideTaskAdmission, estimateAttentionForTask, estimateConfidenceFromProfile, estimateLearningPercentile, estimateLearningVariance, estimateForClassification, estimateProfileConfidenceScore, estimateUtilityForTask, isInterruptedUsageActual, normalizeHybridExecutionPlan, mutationRequiresRepositoryClaim, normalizePlanningPolicy, normalizePredictiveReservePolicy, normalizeTaskPlanProposal, normalizeExecutionProfile, normalizeAttentionPolicy, normalizeTaskAdmissionPolicy, normalizeUtilityPolicy, predictReserveForCapacityPlan, progressivelyAdmitPlanProposal, rankPlannedTaskNodes, reservationHasCapacity, reserveCreditsForEstimate, routeAndReserveCapacity, scoreCapacityLane, selectBestCapacityLane, selectTaskEstimateProfile, settleCapacityActuals, shouldInterruptForCapacity, synthesizePlanEstimate, createReservationReleaseEntry, summarizeCapacityPlan, summarizeProjectCapacityPlan, summarizeTeamCapacityPlan, validateTaskPlanProposal, } from './capacity.ts';
 export { executeKnowledgeHubProviderLaunch, validateKnowledgeHubProviderLaunchPrerequisites, } from './operations/services/hub-provider-launch.ts';
 export { createKnowledgeHubRepositories, defaultHubContentResolutionPolicy, executeKnowledgeHubLaunch, normalizeKnowledgeHubLaunchIntent, planKnowledgeHubLaunch, planKnowledgeHubRepositories, validateRepositoryHost, type HubContentResolutionPolicy, type KnowledgeHubLaunchIntent, type KnowledgeHubLaunchPhase, type KnowledgeHubLaunchPlan, type KnowledgeHubLaunchResult, type KnowledgeHubRepositoryPlan, type RepositoryHost, } from './operations/services/hub-launch.ts';

package/dist/index.js

@@ -25,6 +25,37 @@ import {
   resolveCapacityProviderEnvironment,
   resolveCapacityProviderLaunchEnvironment
 } from "./capacity-provider.js";
+import {
+  PLATFORM_OPERATION_ENDPOINTS,
+  PLATFORM_OPERATION_NAMESPACES,
+  PLATFORM_OPERATION_SCOPES,
+  PLATFORM_OPERATION_STATUSES,
+  PLATFORM_OPERATION_TARGETS,
+  PlatformOperationApiError,
+  PlatformRunnerClient,
+  assertPlatformOperation,
+  assertPlatformOperationEvent,
+  assertPlatformOperationOkEnvelope,
+  buildPlatformRunnerAuthHeaders,
+  createPlatformOperationExecutorRegistry,
+  derivePlatformOperationNavigation,
+  isPlatformOperationSuccessful,
+  isPlatformOperationTerminal,
+  pollPlatformOperation,
+  runPlatformOperationOnce
+} from "./platform-operations.js";
+import {
+  PLATFORM_CONTENT_COLLECTIONS,
+  PLATFORM_WORK_CONTENT_COLLECTIONS,
+  createPlatformRepositoryClaim,
+  derivePlatformRepositoryKey,
+  executePlatformRepositoryOperation,
+  normalizePlatformContentInput,
+  normalizePlatformRelationArray,
+  platformContentRelationPolicy,
+  resolvePlatformRepositoryWorkspacePath,
+  slugifyPlatformContent
+} from "./operations/repository-operations.js";
 import {
   DEFAULT_EXECUTION_PROFILE_ID,
   DEFAULT_EXECUTION_PROFILES,
@@ -290,9 +321,18 @@ export {
   MarketApiError,
   MarketClient,
   MarketProviderClient,
+  PLATFORM_CONTENT_COLLECTIONS,
+  PLATFORM_OPERATION_ENDPOINTS,
+  PLATFORM_OPERATION_NAMESPACES,
+  PLATFORM_OPERATION_SCOPES,
+  PLATFORM_OPERATION_STATUSES,
+  PLATFORM_OPERATION_TARGETS,
+  PLATFORM_WORK_CONTENT_COLLECTIONS,
   PROJECT_JOB_STATUSES,
   PROJECT_TEAM_CAPABILITIES,
   PUBLISHED_CONTENT_MANIFEST_SCHEMA_VERSION,
+  PlatformOperationApiError,
+  PlatformRunnerClient,
   RELEASE_STATES,
   RemoteTemplateCatalogClient,
   RemoteTreeseedAuthClient,
@@ -319,11 +359,15 @@ export {
   assertCapacityProviderOkEnvelope,
   assertCapacityProviderPortfolioManifest,
   assertCapacityProviderRegistrationResponse,
+  assertPlatformOperation,
+  assertPlatformOperationEvent,
+  assertPlatformOperationOkEnvelope,
   buildBuiltinModelRegistry,
   buildCapacityProviderAuthHeaders,
   buildCopilotAllowToolArgs,
   buildKnowledgePackMarketPackage,
   buildModelRegistry,
+  buildPlatformRunnerAuthHeaders,
   buildScopedModelRegistry,
   buildTaskEstimateProfileFromActuals,
   buildTemplateMarketPackage,
@@ -339,6 +383,8 @@ export {
   createDefaultGraphRankingProvider,
   createFilesystemContentSource,
   createKnowledgeHubRepositories,
+  createPlatformOperationExecutorRegistry,
+  createPlatformRepositoryClaim,
   createPublishedContentPipeline,
   createReservationReleaseEntry,
   createTeamScopedR2OverlayContentPublishProvider,
@@ -353,6 +399,8 @@ export {
   deniedAgentOperationResult,
   deployCapacityProviderToManagedMarketHost,
   deployCapacityProviderToRailway,
+  derivePlatformOperationNavigation,
+  derivePlatformRepositoryKey,
   deriveTreeseedDesiredUnits,
   destroyTreeseedTargetUnits,
   ensureRailwayEnvironment,
@@ -367,6 +415,7 @@ export {
   estimateUtilityForTask,
   executeKnowledgeHubLaunch,
   executeKnowledgeHubProviderLaunch,
+  executePlatformRepositoryOperation,
   executeSdkOperation,
   findDispatchCapability,
   findSdkOperation,
@@ -380,6 +429,8 @@ export {
   isAgentOperationName,
   isCapacityProviderSecretEnvKey,
   isInterruptedUsageActual,
+  isPlatformOperationSuccessful,
+  isPlatformOperationTerminal,
   isTeamScopedR2ContentEnabled,
   listIntegratedMarketCatalog,
   listRailwayEnvironments,
@@ -404,6 +455,8 @@ export {
   normalizeKnowledgeHubLaunchIntent,
   normalizeMutationData,
   normalizePlanningPolicy,
+  normalizePlatformContentInput,
+  normalizePlatformRelationArray,
   normalizePredictiveReservePolicy,
   normalizeProjectJobStatus,
   normalizeRecordToCanonicalShape,
@@ -422,6 +475,8 @@ export {
   planKnowledgeHubLaunch,
   planKnowledgeHubRepositories,
   planTreeseedReconciliation,
+  platformContentRelationPolicy,
+  pollPlatformOperation,
   predictReserveForCapacityPlan,
   preprocessAliasedRecord,
   progressivelyAdmitPlanProposal,
@@ -450,6 +505,7 @@ export {
   resolveMarketSession,
   resolveModelDefinition,
   resolveModelField,
+  resolvePlatformRepositoryWorkspacePath,
   resolvePublishedContentBucketBinding,
   resolvePublishedContentManifestKey,
   resolvePublishedContentPreviewRoot,
@@ -464,6 +520,7 @@ export {
   resolveTreeseedToolBinary,
   resolveTreeseedToolCommand,
   routeAndReserveCapacity,
+  runPlatformOperationOnce,
   runTreeseedCopilotTask,
   runTreeseedVerifyDriver,
   scoreCapacityLane,
@@ -474,6 +531,7 @@ export {
   settleCapacityActuals,
   shouldInterruptForCapacity,
   signEditorialPreviewToken,
+  slugifyPlatformContent,
   summarizeCapacityPlan,
   summarizeProjectCapacityPlan,
   summarizeTeamCapacityPlan,

package/dist/operations/repository-operations.d.ts

@@ -0,0 +1,129 @@
+export declare const PLATFORM_CONTENT_COLLECTIONS: readonly ["objectives", "questions", "notes", "proposals", "decisions", "agents"];
+export declare const PLATFORM_WORK_CONTENT_COLLECTIONS: readonly ["objectives", "questions", "notes", "proposals", "decisions"];
+export type PlatformContentCollection = (typeof PLATFORM_CONTENT_COLLECTIONS)[number];
+export interface PlatformRepositoryDescriptor {
+    provider?: 'github' | 'local' | string;
+    owner?: string;
+    name: string;
+    defaultBranch?: string;
+    cloneUrl: string;
+    writeMode?: 'workspace' | 'branch' | 'direct' | 'pull_request';
+    branchName?: string;
+    push?: boolean;
+    pathPolicies?: PlatformRepositoryPathPolicy[];
+    verificationCommands?: PlatformRepositoryVerificationCommand[];
+}
+export interface PlatformRepositoryPathPolicy {
+    allow: string;
+}
+export interface PlatformRepositoryVerificationCommand {
+    command: string;
+    args?: string[];
+    workingDirectory?: string;
+    timeoutMs?: number;
+}
+export interface PlatformRepositoryClaimInput {
+    repository: PlatformRepositoryDescriptor;
+    runnerId: string;
+    workspaceRoot: string;
+    branch?: string | null;
+    commitSha?: string | null;
+    leaseSeconds?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface PlatformRepositoryClaim {
+    id: string;
+    repositoryKey: string;
+    runnerId: string;
+    workspacePath: string;
+    branch: string | null;
+    commitSha: string | null;
+    claimState: 'active' | 'released' | 'expired' | string;
+    leaseExpiresAt: string | null;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PlatformRepositoryOperationInput {
+    projectId?: string;
+    teamId?: string;
+    createdBy?: string;
+    repository: PlatformRepositoryDescriptor;
+    collection?: string;
+    parentCollection?: string;
+    parentSlug?: string;
+    targetCollection?: string;
+    proposalSlugs?: string[];
+    decisionType?: string;
+    reason?: string;
+    title?: string;
+    slug?: string;
+    normalized?: NormalizedPlatformContentInput;
+    payload?: Record<string, unknown>;
+    commitMessage?: string;
+    approvalRequired?: boolean;
+    approvalId?: string;
+}
+export interface PlatformRepositoryOperationOptions {
+    workspaceRoot: string;
+    environment?: string;
+}
+export interface NormalizedPlatformContentInput {
+    slug: string;
+    extension: 'md' | 'mdx';
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export interface PlatformRepositoryOperationResult {
+    ok: true;
+    operation: string;
+    repository: {
+        key: string;
+        provider: string;
+        owner: string | null;
+        name: string;
+        cloneUrl: string;
+    };
+    baseBranch: string;
+    repositoryPath: string;
+    workspacePath: string;
+    href: string | null;
+    branch: string | null;
+    operationBranch: string | null;
+    commitSha: string | null;
+    changedPaths: string[];
+    verification: PlatformRepositoryVerificationResult | null;
+    pullRequest: null;
+    workflowRun: null;
+    output: Record<string, unknown>;
+}
+export interface PlatformRepositoryVerificationResult {
+    status: 'passed' | 'failed' | 'skipped';
+    commands: Array<{
+        command: string;
+        args: string[];
+        cwd: string;
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+    }>;
+}
+export declare class PlatformRepositoryVerificationError extends Error {
+    readonly verification: PlatformRepositoryVerificationResult;
+    constructor(message: string, verification: PlatformRepositoryVerificationResult);
+}
+export declare function slugifyPlatformContent(value: unknown): string;
+export declare function normalizePlatformRelationArray(value: unknown): string[];
+export declare function platformContentRelationPolicy(parentCollection: string, targetCollection: string): {
+    sourceField?: string;
+    targetField?: string;
+    sourceSingle?: boolean;
+    targetSingle?: boolean;
+};
+export declare function normalizePlatformContentInput(collection: string, body: Record<string, unknown>): NormalizedPlatformContentInput | {
+    error: string;
+};
+export declare function derivePlatformRepositoryKey(repository: PlatformRepositoryDescriptor): string;
+export declare function resolvePlatformRepositoryWorkspacePath(workspaceRoot: string, repository: PlatformRepositoryDescriptor): string;
+export declare function createPlatformRepositoryClaim(input: PlatformRepositoryClaimInput): PlatformRepositoryClaim;
+export declare function executePlatformRepositoryOperation(operation: 'write_content_record' | 'create_related_content' | 'create_decision_from_proposals' | string, input: PlatformRepositoryOperationInput, options: PlatformRepositoryOperationOptions): Promise<PlatformRepositoryOperationResult>;