@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/sdk-types/support/platform-contracts.d.ts

@@ -0,0 +1,178 @@
+import { SdkDispatchExecutionClass, SdkDispatchNamespace, SdkDispatchPolicy, SdkDispatchTarget, TreeDxDeploymentProvider, TreeDxInstanceKind, TreeDxInstanceStatus, TreeDxMirrorDirection, TreeDxMirrorStatus, TreeDxShareScope, TreeDxShareStatus } from './sdk-model-names.js';
+export interface TreeDxInstance {
+    id: string;
+    teamId: string;
+    kind: TreeDxInstanceKind;
+    provider: TreeDxDeploymentProvider | (string & {});
+    name: string;
+    baseUrl?: string | null;
+    registryUrl?: string | null;
+    publicRead: boolean;
+    primary: boolean;
+    status: TreeDxInstanceStatus;
+    imageRef?: string | null;
+    railwayProjectId?: string | null;
+    railwayServiceId?: string | null;
+    railwayEnvironmentId?: string | null;
+    volumeMountPath?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface TreeDxDeployment {
+    id: string;
+    teamId: string;
+    instanceId?: string | null;
+    provider: TreeDxDeploymentProvider | (string & {});
+    status: string;
+    imageRef?: string | null;
+    volumeMountPath?: string | null;
+    serviceRefs?: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    error?: Record<string, unknown> | null;
+    createdAt?: string;
+    updatedAt?: string;
+    completedAt?: string | null;
+}
+export interface TreeDxDeploymentRequest {
+    teamId: string;
+    instanceId?: string | null;
+    deploymentId?: string | null;
+    provider?: TreeDxDeploymentProvider | (string & {});
+    imageRef?: string | null;
+    volumeMountPath?: string | null;
+    publicRead?: boolean;
+    baseUrl?: string | null;
+    planOnly?: boolean;
+}
+export interface TreeDxDeploymentResult {
+    ok: boolean;
+    teamId: string;
+    instanceId: string;
+    deploymentId: string;
+    provider: TreeDxDeploymentProvider | (string & {});
+    status: string;
+    baseUrl?: string | null;
+    imageRef?: string | null;
+    volumeMountPath?: string | null;
+    serviceRefs?: Record<string, unknown>;
+    health?: Record<string, unknown> | string | null;
+    error?: Record<string, unknown> | null;
+}
+export interface TreeDxMirror {
+    id: string;
+    teamId: string;
+    instanceId: string;
+    name: string;
+    direction: TreeDxMirrorDirection;
+    targetKind: string;
+    targetUrl?: string | null;
+    status: TreeDxMirrorStatus;
+    instructions?: string | null;
+    lastSyncAt?: string | null;
+    lastSyncStatus?: string | null;
+    lastSyncMetadata?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface TreeDxShareLink {
+    id: string;
+    teamId: string;
+    instanceId?: string | null;
+    projectId?: string | null;
+    libraryId?: string | null;
+    scope: TreeDxShareScope;
+    targetTeamId?: string | null;
+    trustGrant?: Record<string, unknown>;
+    publicRead: boolean;
+    status: TreeDxShareStatus;
+    expiresAt?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+    revokedAt?: string | null;
+}
+export interface TreeDxProjectLibraryBinding {
+    id: string;
+    teamId: string;
+    projectId: string;
+    instanceId: string;
+    libraryId: string;
+    repositoryId?: string | null;
+    contentPath: string;
+    contentRepositoryUrl?: string | null;
+    contentRepositoryDefaultBranch?: string | null;
+    contentRepositoryRef?: string | null;
+    r2BucketName?: string | null;
+    r2ManifestKey?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ProjectContentRepositoryTopology {
+    accessMode: 'treedx';
+    githubUrl?: string | null;
+    defaultBranch?: string | null;
+    ref?: string | null;
+    contentPath: string;
+    treeDx: {
+        instanceId: string;
+        libraryId: string;
+        repositoryId?: string | null;
+        baseUrl?: string | null;
+    };
+    remote?: {
+        bindingId: string;
+        serviceConnectionId: string;
+        capabilityBindingId: string;
+        providerId: string;
+        providerRepositoryId: string;
+        owner: string;
+        name: string;
+        cloneUrl: string;
+        defaultRef: string;
+        publicationRef: string;
+        authorityId: string;
+        expectedHead?: string | null;
+        observedHead?: string | null;
+        grantStatus: 'ready' | 'missing' | 'suspended' | 'reauthorization-required';
+        drift: 'none' | 'remote-ahead' | 'remote-behind' | 'diverged' | 'unavailable' | 'unknown';
+        version: number;
+    } | null;
+    r2?: {
+        bucketName?: string | null;
+        manifestKey?: string | null;
+        publicBaseUrl?: string | null;
+    };
+}
+export interface ProjectFilesystemRepositoryTopology {
+    accessMode: 'filesystem';
+    provider?: string | null;
+    owner?: string | null;
+    name?: string | null;
+    url?: string | null;
+    defaultBranch?: string | null;
+    ref?: string | null;
+    checkoutPath?: string | null;
+    volumePath?: string | null;
+    submoduleMountPath?: string | null;
+    siteSubmodulePath?: string | null;
+}
+export interface ProjectRepositoryTopology {
+    contentRepository: ProjectContentRepositoryTopology;
+    siteRepository: ProjectFilesystemRepositoryTopology;
+    projectRepository?: ProjectFilesystemRepositoryTopology | null;
+}
+export interface SdkDispatchCapability {
+    namespace: SdkDispatchNamespace;
+    operation: string;
+    executionClass: SdkDispatchExecutionClass;
+    allowedTargets: SdkDispatchTarget[];
+    defaultTarget: SdkDispatchTarget;
+    defaultDispatchMode: SdkDispatchPolicy;
+    summary?: string;
+}
+export declare const PUBLICATION_ACCESS_MODES: readonly ["free", "private", "contact", "one_time", "one_time_current_version", "subscription", "subscription_updates", "professional_hosting", "scoped_contract", "external"];
+export type PublicationAccessMode = typeof PUBLICATION_ACCESS_MODES[number];
+export type CatalogItemOfferMode = PublicationAccessMode;

package/dist/sdk-types/support/platform-contracts.js

@@ -0,0 +1,15 @@
+const PUBLICATION_ACCESS_MODES = [
+  "free",
+  "private",
+  "contact",
+  "one_time",
+  "one_time_current_version",
+  "subscription",
+  "subscription_updates",
+  "professional_hosting",
+  "scoped_contract",
+  "external"
+];
+export {
+  PUBLICATION_ACCESS_MODES
+};

package/dist/sdk-types/support/sdk-model-names.d.ts

@@ -0,0 +1,44 @@
+export declare const SDK_MODEL_NAMES: readonly ["page", "note", "question", "proposal", "decision", "book", "knowledge", "objective", "person", "subscription", "message", "discussion", "discussion_message", "discussion_event", "group", "group_edge", "agent", "agent_context_query", "agent_context_query_set", "agent_instruction_template", "discussion_topic", "assignment_plan", "assignment_status", "assignment_summary", "agent_evaluation", "agent_run", "agent_cursor", "content_lease", "approval_request", "team_inbox_item"];
+export declare const SDK_OPERATIONS: readonly ["get", "read", "search", "follow", "pick", "create", "update"];
+export declare const SDK_STORAGE_BACKENDS: readonly ["content", "d1"];
+export declare const SDK_PICK_STRATEGIES: readonly ["latest", "highest_priority", "oldest"];
+export declare const SDK_DISPATCH_EXECUTION_CLASSES: readonly ["local_only", "remote_inline", "remote_job"];
+export declare const SDK_DISPATCH_TARGETS: readonly ["local", "project_api", "project_runner", "market_catalog"];
+export declare const SDK_DISPATCH_POLICIES: readonly ["auto", "prefer_local", "prefer_remote", "remote_only"];
+export declare const SDK_DISPATCH_NAMESPACES: readonly ["sdk", "workflow"];
+export declare const REMOTE_JOB_STATUSES: readonly ["pending", "claimed", "running", "completed", "failed", "cancelled"];
+export declare const PROJECT_ENVIRONMENT_NAMES: readonly ["local", "staging", "prod"];
+export declare const DEFAULT_STARTER_TEMPLATE_ID: "research";
+export declare const TEMPLATE_ID_ALIASES: {};
+export declare function normalizeTemplateId(templateId: string | null | undefined): string;
+export declare const TREEDX_INSTANCE_KINDS: readonly ["managed_private", "managed_public_federation", "self_hosted"];
+export declare const TREEDX_INSTANCE_STATUSES: readonly ["pending", "active", "degraded", "offline", "disabled"];
+export declare const TREEDX_DEPLOYMENT_PROVIDERS: readonly ["railway", "self_hosted", "public_federation"];
+export declare const TREEDX_MIRROR_DIRECTIONS: readonly ["pull", "push", "bidirectional"];
+export declare const TREEDX_MIRROR_STATUSES: readonly ["pending", "active", "syncing", "degraded", "disabled"];
+export declare const TREEDX_SHARE_SCOPES: readonly ["team", "library", "public_federation"];
+export declare const TREEDX_SHARE_STATUSES: readonly ["active", "revoked", "expired"];
+export declare const PROJECT_REPOSITORY_ACCESS_MODES: readonly ["treedx", "filesystem"];
+export declare const PROJECT_REPOSITORY_TOPOLOGY_PARTS: readonly ["contentRepository", "siteRepository", "projectRepository"];
+export type SdkBuiltinModelName = (typeof SDK_MODEL_NAMES)[number];
+export type SdkModelName = SdkBuiltinModelName | (string & {});
+export type SdkOperation = (typeof SDK_OPERATIONS)[number];
+export type SdkStorageBackend = (typeof SDK_STORAGE_BACKENDS)[number];
+export type SdkPickStrategy = (typeof SDK_PICK_STRATEGIES)[number];
+export type SdkComparableAs = 'string' | 'number' | 'date' | 'boolean' | 'string_array';
+export type SdkDispatchExecutionClass = (typeof SDK_DISPATCH_EXECUTION_CLASSES)[number];
+export type SdkDispatchTarget = (typeof SDK_DISPATCH_TARGETS)[number];
+export type SdkDispatchPolicy = (typeof SDK_DISPATCH_POLICIES)[number];
+export type SdkDispatchNamespace = (typeof SDK_DISPATCH_NAMESPACES)[number];
+export type RemoteJobStatus = (typeof REMOTE_JOB_STATUSES)[number];
+export type ProjectEnvironmentName = (typeof PROJECT_ENVIRONMENT_NAMES)[number];
+export type RemoteJobRequestedByType = 'user' | 'team_api_key' | 'service' | 'runner' | 'system';
+export type TreeDxInstanceKind = (typeof TREEDX_INSTANCE_KINDS)[number];
+export type TreeDxInstanceStatus = (typeof TREEDX_INSTANCE_STATUSES)[number];
+export type TreeDxDeploymentProvider = (typeof TREEDX_DEPLOYMENT_PROVIDERS)[number];
+export type TreeDxMirrorDirection = (typeof TREEDX_MIRROR_DIRECTIONS)[number];
+export type TreeDxMirrorStatus = (typeof TREEDX_MIRROR_STATUSES)[number];
+export type TreeDxShareScope = (typeof TREEDX_SHARE_SCOPES)[number];
+export type TreeDxShareStatus = (typeof TREEDX_SHARE_STATUSES)[number];
+export type ProjectRepositoryAccessMode = (typeof PROJECT_REPOSITORY_ACCESS_MODES)[number];
+export type ProjectRepositoryTopologyPart = (typeof PROJECT_REPOSITORY_TOPOLOGY_PARTS)[number];

package/dist/sdk-types/support/sdk-model-names.js

@@ -0,0 +1,80 @@
+const SDK_MODEL_NAMES = [
+  "page",
+  "note",
+  "question",
+  "proposal",
+  "decision",
+  "book",
+  "knowledge",
+  "objective",
+  "person",
+  "subscription",
+  "message",
+  "discussion",
+  "discussion_message",
+  "discussion_event",
+  "group",
+  "group_edge",
+  "agent",
+  "agent_context_query",
+  "agent_context_query_set",
+  "agent_instruction_template",
+  "discussion_topic",
+  "assignment_plan",
+  "assignment_status",
+  "assignment_summary",
+  "agent_evaluation",
+  "agent_run",
+  "agent_cursor",
+  "content_lease",
+  "approval_request",
+  "team_inbox_item"
+];
+const SDK_OPERATIONS = ["get", "read", "search", "follow", "pick", "create", "update"];
+const SDK_STORAGE_BACKENDS = ["content", "d1"];
+const SDK_PICK_STRATEGIES = ["latest", "highest_priority", "oldest"];
+const SDK_DISPATCH_EXECUTION_CLASSES = ["local_only", "remote_inline", "remote_job"];
+const SDK_DISPATCH_TARGETS = ["local", "project_api", "project_runner", "market_catalog"];
+const SDK_DISPATCH_POLICIES = ["auto", "prefer_local", "prefer_remote", "remote_only"];
+const SDK_DISPATCH_NAMESPACES = ["sdk", "workflow"];
+const REMOTE_JOB_STATUSES = ["pending", "claimed", "running", "completed", "failed", "cancelled"];
+const PROJECT_ENVIRONMENT_NAMES = ["local", "staging", "prod"];
+const DEFAULT_STARTER_TEMPLATE_ID = "research";
+const TEMPLATE_ID_ALIASES = {};
+function normalizeTemplateId(templateId) {
+  const trimmed = String(templateId ?? "").trim();
+  return TEMPLATE_ID_ALIASES[trimmed] ?? trimmed;
+}
+const TREEDX_INSTANCE_KINDS = ["managed_private", "managed_public_federation", "self_hosted"];
+const TREEDX_INSTANCE_STATUSES = ["pending", "active", "degraded", "offline", "disabled"];
+const TREEDX_DEPLOYMENT_PROVIDERS = ["railway", "self_hosted", "public_federation"];
+const TREEDX_MIRROR_DIRECTIONS = ["pull", "push", "bidirectional"];
+const TREEDX_MIRROR_STATUSES = ["pending", "active", "syncing", "degraded", "disabled"];
+const TREEDX_SHARE_SCOPES = ["team", "library", "public_federation"];
+const TREEDX_SHARE_STATUSES = ["active", "revoked", "expired"];
+const PROJECT_REPOSITORY_ACCESS_MODES = ["treedx", "filesystem"];
+const PROJECT_REPOSITORY_TOPOLOGY_PARTS = ["contentRepository", "siteRepository", "projectRepository"];
+export {
+  DEFAULT_STARTER_TEMPLATE_ID,
+  PROJECT_ENVIRONMENT_NAMES,
+  PROJECT_REPOSITORY_ACCESS_MODES,
+  PROJECT_REPOSITORY_TOPOLOGY_PARTS,
+  REMOTE_JOB_STATUSES,
+  SDK_DISPATCH_EXECUTION_CLASSES,
+  SDK_DISPATCH_NAMESPACES,
+  SDK_DISPATCH_POLICIES,
+  SDK_DISPATCH_TARGETS,
+  SDK_MODEL_NAMES,
+  SDK_OPERATIONS,
+  SDK_PICK_STRATEGIES,
+  SDK_STORAGE_BACKENDS,
+  TEMPLATE_ID_ALIASES,
+  TREEDX_DEPLOYMENT_PROVIDERS,
+  TREEDX_INSTANCE_KINDS,
+  TREEDX_INSTANCE_STATUSES,
+  TREEDX_MIRROR_DIRECTIONS,
+  TREEDX_MIRROR_STATUSES,
+  TREEDX_SHARE_SCOPES,
+  TREEDX_SHARE_STATUSES,
+  normalizeTemplateId
+};

package/dist/sdk-types/support/sdk-search-request.d.ts

@@ -0,0 +1,182 @@
+import type { FieldAliasBinding } from '../../entrypoints/models/field-aliases.js';
+import { SdkFilterCondition, SdkSortSpec } from '../configuration/sdk-dispatch-credential-source.js';
+import { SdkComparableAs, SdkModelName, SdkOperation, SdkPickStrategy, SdkStorageBackend } from './sdk-model-names.js';
+export interface SdkSearchRequest {
+    model: SdkModelName;
+    filters?: SdkFilterCondition[];
+    sort?: SdkSortSpec[];
+    limit?: number;
+    cursor?: string | null;
+}
+export interface SdkGetRequest {
+    model: SdkModelName;
+    id?: string;
+    slug?: string;
+    key?: string;
+}
+export interface SdkFollowRequest {
+    model: SdkModelName;
+    since: string;
+    filters?: SdkFilterCondition[];
+    timeoutSeconds?: number;
+}
+export interface SdkPickRequest {
+    model: SdkModelName;
+    strategy?: SdkPickStrategy;
+    filters?: SdkFilterCondition[];
+    leaseSeconds: number;
+    workerId: string;
+}
+export interface SdkMutationRequest {
+    model: SdkModelName;
+    data: Record<string, unknown>;
+    actor: string;
+}
+export interface SdkUpdateRequest extends SdkMutationRequest {
+    id?: string;
+    slug?: string;
+    key?: string;
+    expectedVersion?: string;
+}
+export interface SdkModelFieldBinding extends FieldAliasBinding {
+    aliases?: string[];
+    contentKeys?: string[];
+    dbColumns?: string[];
+    payloadPaths?: string[];
+    writeContentKey?: string;
+    writeDbColumn?: string;
+    filterable?: boolean;
+    sortable?: boolean;
+    comparableAs?: SdkComparableAs;
+    normalize?: (value: unknown) => unknown;
+}
+export interface SdkModelDefinition {
+    name: SdkModelName;
+    aliases: string[];
+    storage: SdkStorageBackend;
+    operations: SdkOperation[];
+    fields: Record<string, SdkModelFieldBinding>;
+    filterableFields: string[];
+    sortableFields: string[];
+    pickField: string;
+    contentCollection?: string;
+    contentDir?: string;
+    graph?: SdkGraphModelConfig;
+}
+export type SdkModelRegistry = Record<string, SdkModelDefinition>;
+export type SdkGraphNodeType = 'File' | 'Section' | 'Agent' | 'Objective' | 'Question' | 'Note' | 'Proposal' | 'Decision' | 'Knowledge' | 'Book' | 'Page' | 'Person' | 'Group' | 'Series' | 'Reference' | 'Entity';
+export type SdkGraphEdgeType = 'HAS_SECTION' | 'BELONGS_TO_FILE' | 'PARENT_SECTION' | 'CHILD_SECTION' | 'NEXT_SECTION' | 'PREV_SECTION' | 'LINKS_TO' | 'REFERENCES' | 'MENTIONS' | 'HAS_GROUP' | 'EFFECTIVE_GROUP' | 'GROUP_RELATION' | 'IN_SERIES' | 'SAME_DIRECTORY' | 'SAME_COLLECTION' | 'DEFINES' | 'DEFINED_BY' | 'RELATES_TO' | 'DEPENDS_ON' | 'IMPLEMENTS' | 'EXTENDS' | 'SUPERSEDES' | 'BELONGS_TO' | 'ABOUT' | 'USED_BY' | 'GENERATED_FROM';
+export interface SdkGraphReferenceFieldConfig {
+    field: string;
+    edgeType?: Exclude<SdkGraphEdgeType, 'HAS_SECTION' | 'BELONGS_TO_FILE' | 'PARENT_SECTION' | 'CHILD_SECTION' | 'NEXT_SECTION' | 'PREV_SECTION' | 'LINKS_TO' | 'MENTIONS' | 'SAME_DIRECTORY' | 'SAME_COLLECTION' | 'DEFINES' | 'DEFINED_BY'>;
+    targetModels?: string[];
+    multiple?: boolean;
+}
+export interface SdkGraphModelConfig {
+    entityType?: SdkGraphNodeType;
+    referenceFields?: SdkGraphReferenceFieldConfig[];
+    groupField?: string;
+    seriesField?: string;
+    titleField?: string;
+    enableSections?: boolean;
+}
+export interface SdkGraphRefreshRequest {
+    paths?: string[];
+}
+export interface SdkGraphQueryOptions {
+    limit?: number;
+    models?: string[];
+    nodeTypes?: SdkGraphNodeType[];
+    edgeTypes?: SdkGraphEdgeType[];
+    direction?: 'outgoing' | 'incoming' | 'both';
+    depth?: number;
+    scoreThreshold?: number;
+    maxNodes?: number;
+    cycleDetection?: boolean;
+    edgeWeights?: Partial<Record<SdkGraphEdgeType, number>>;
+}
+export interface SdkGraphSearchOptions extends SdkGraphQueryOptions {
+    prefix?: boolean;
+    fuzzy?: number | boolean;
+}
+export interface SdkResolveReferenceOptions {
+    fromNodeId?: string;
+    fromPath?: string;
+    models?: string[];
+}
+export interface SdkGraphNode {
+    id: string;
+    nodeType: SdkGraphNodeType;
+    sourceModel?: string;
+    entityType?: string;
+    ownerFileId?: string;
+    path?: string;
+    slug?: string;
+    title?: string;
+    heading?: string | null;
+    headingPath?: string | null;
+    level?: number | null;
+    text?: string;
+    groupIds?: string[];
+    effectiveGroupIds?: string[];
+    series?: string | null;
+    fileId?: string;
+    entityId?: string;
+    status?: string | null;
+    canonical?: boolean;
+    canonicalId?: string | null;
+    version?: string | null;
+    domain?: string | null;
+    audience?: string[];
+    updatedAt?: string | null;
+    data?: Record<string, unknown>;
+}
+export interface SdkGraphEdge {
+    id: string;
+    type: SdkGraphEdgeType;
+    sourceId: string;
+    targetId: string;
+    ownerFileId?: string;
+    data?: Record<string, unknown>;
+}
+export interface SdkGraphSearchResult {
+    node: SdkGraphNode;
+    score: number;
+    reason: string;
+    highlights?: string[];
+    context?: Record<string, unknown>;
+}
+export interface SdkGraphRankingDiagnostics {
+    providerId: string;
+    lexicalScore: number;
+    graphScore: number;
+    priorScore: number;
+    canonicalityScore: number;
+    freshnessScore: number;
+    stageScore: number;
+    finalScore: number;
+}
+export interface SdkGraphTraversalResult {
+    seedId: string;
+    nodes: SdkGraphNode[];
+    edges: SdkGraphEdge[];
+}
+export interface SdkGraphSeed {
+    id: string;
+    kind: 'id' | 'path' | 'query' | 'group' | 'type';
+    value: string;
+    scope?: 'files' | 'sections' | 'entities';
+}
+export type SdkGraphQueryStage = 'plan' | 'implement' | 'research' | 'debug' | 'review';
+export type SdkGraphQueryView = 'list' | 'brief' | 'full' | 'map';
+export type SdkGraphDslRelation = 'related' | 'depends_on' | 'implements' | 'references' | 'parent' | 'child' | 'supersedes';
+export interface SdkGraphWhereFilter {
+    field: 'type' | 'model' | 'status' | 'audience' | 'directGroupId' | 'effectiveGroupId' | 'domain';
+    op: 'eq' | 'in';
+    value: string | string[];
+}
+export interface SdkGraphSeedResolution {
+    seeds: SdkGraphSeed[];
+    matches: SdkGraphSearchResult[];
+    resolvedNodeIds: string[];
+}