@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/sdk.js

@@ -1,825 +0,0 @@
-import { resolveSdkRepoRoot } from "./runtime.js";
-import { normalizeAgentCliOptions } from "./cli-tools.js";
-import { ContentStore } from "./content-store.js";
-import { CloudflareD1AgentDatabase, MemoryAgentDatabase } from "./d1-store.js";
-import { ContentGraphRuntime } from "./graph.js";
-import {
-  createTreeDxClientFromAgentOptions,
-  LocalContentBackend,
-  LocalGraphBackend,
-  MissingTreeDxContentBackend,
-  resolveTreeDxOptions,
-  TreeDxContentBackend,
-  TreeDxGraphBackend,
-  TreeDxPortfolioResolver
-} from "./treedx-backends.js";
-import {
-  LocalGraphPort,
-  LocalRepositoryPort,
-  LocalRepositoryQueryPort,
-  TreeDxArtifactPort,
-  TreeDxExecPort,
-  TreeDxFederatedClient,
-  TreeDxFederatedPort,
-  TreeDxGraphAdapter,
-  TreeDxGraphPort,
-  TreeDxRegistryClient,
-  TreeDxRegistryPort,
-  TreeDxRepositoryPort,
-  TreeDxRepositoryQueryPort,
-  TreeDxClient as PublicTreeDxClient
-} from "./treedx/index.js";
-import { loadTreeseedPlugins } from "./platform/plugins.js";
-import { buildScopedModelRegistry, resolveModelDefinition } from "./model-registry.js";
-import { findDispatchCapability } from "./dispatch.js";
-import { RemoteTreeseedClient, RemoteTreeseedDispatchClient } from "./remote.js";
-import { executeSdkOperation } from "./sdk-dispatch.js";
-import { TreeseedOperationsSdk } from "./operations/runtime.js";
-import { NodeSqliteD1Database } from "./db/node-sqlite.js";
-function normalizeAgentSpec(entry) {
-  if (!entry) {
-    return null;
-  }
-  const frontmatter = entry.frontmatter ?? {};
-  return {
-    ...frontmatter,
-    slug: String(frontmatter.slug ?? entry.slug ?? ""),
-    cli: normalizeAgentCliOptions(frontmatter.cli)
-  };
-}
-function normalizeOperation(operation) {
-  return operation === "read" ? "get" : operation;
-}
-function operationAllowed(permissions, model, operation) {
-  const normalizedOperation = normalizeOperation(operation);
-  return permissions.some(
-    (permission) => permission.model === model && permission.operations.map(normalizeOperation).includes(normalizedOperation)
-  );
-}
-class AgentSdk {
-  repoRoot;
-  database;
-  content;
-  models;
-  ports;
-  treeDx;
-  localContentStore;
-  localGraphRuntime;
-  graph;
-  dispatchConfig;
-  constructor(options = {}) {
-    const rawTreeDxOptions = options.treeDx;
-    if (rawTreeDxOptions && !options.repoRoot && !options.models && !options.modelRegistry) {
-      throw new Error("AgentSdk TreeDX mode requires explicit models or modelRegistry.");
-    }
-    const repoRoot = options.repoRoot ? resolveSdkRepoRoot(options.repoRoot) : rawTreeDxOptions ? process.cwd() : resolveSdkRepoRoot();
-    this.repoRoot = repoRoot;
-    this.models = options.modelRegistry ?? buildScopedModelRegistry(repoRoot, options.models);
-    this.database = options.database ?? new MemoryAgentDatabase();
-    this.localContentStore = new ContentStore(repoRoot, this.database, this.models);
-    let plugins = options.plugins;
-    if (!plugins) {
-      try {
-        plugins = loadTreeseedPlugins();
-      } catch {
-        plugins = [];
-      }
-    }
-    this.localGraphRuntime = new ContentGraphRuntime(repoRoot, this.models, {
-      rankingProvider: options.graphRankingProvider,
-      plugins
-    });
-    const treeDxOptions = resolveTreeDxOptions(options.treeDx);
-    if (options.contentRepository?.adapter === "local") {
-      this.content = new LocalContentBackend(this.localContentStore);
-      this.graph = new LocalGraphBackend(this.localGraphRuntime);
-      this.ports = {
-        repository: new LocalRepositoryPort(this.localContentStore),
-        query: new LocalRepositoryQueryPort(this.localContentStore),
-        graph: new LocalGraphPort(this.localGraphRuntime)
-      };
-    } else if (treeDxOptions) {
-      const publicClient = rawTreeDxOptions?.client instanceof PublicTreeDxClient ? rawTreeDxOptions.client : new PublicTreeDxClient({
-        baseUrl: treeDxOptions.baseUrl,
-        token: treeDxOptions.token,
-        repoId: treeDxOptions.repoId,
-        fetch: treeDxOptions.fetchImpl
-      });
-      const publicFetch = (input, init) => {
-        const headers = init?.headers instanceof Headers ? Object.fromEntries(init.headers.entries()) : init?.headers;
-        return (publicClient.fetchImpl ?? fetch)(input, {
-          ...init,
-          headers
-        });
-      };
-      const client = createTreeDxClientFromAgentOptions({
-        ...treeDxOptions,
-        fetchImpl: treeDxOptions.fetchImpl ?? publicFetch
-      });
-      const resolver = new TreeDxPortfolioResolver({
-        client,
-        repoId: treeDxOptions.repoId,
-        ref: treeDxOptions.ref,
-        repositoryHints: treeDxOptions.repositoryHints
-      });
-      const publicGraph = new TreeDxGraphAdapter({
-        client: publicClient,
-        repoId: treeDxOptions.repoId,
-        defaultRef: treeDxOptions.ref
-      });
-      const publicRegistry = rawTreeDxOptions?.registryRouting ? new TreeDxRegistryClient(publicClient) : void 0;
-      const publicFederated = publicRegistry ? new TreeDxFederatedClient({
-        registry: publicRegistry,
-        token: treeDxOptions.token,
-        fetch: treeDxOptions.fetchImpl
-      }) : void 0;
-      const publicExec = new TreeDxExecPort(publicClient);
-      const publicArtifact = new TreeDxArtifactPort(publicClient);
-      this.content = new TreeDxContentBackend({
-        client,
-        repoRoot,
-        models: this.models,
-        resolver,
-        directRepoId: treeDxOptions.repoId,
-        ref: treeDxOptions.ref,
-        workspaceId: treeDxOptions.workspaceId,
-        contentPathMap: treeDxOptions.contentPathMap,
-        localLeaseStore: this.localContentStore
-      });
-      this.graph = new TreeDxGraphBackend({
-        client,
-        resolver,
-        localRuntime: this.localGraphRuntime,
-        directRepoId: treeDxOptions.repoId,
-        ref: treeDxOptions.ref
-      });
-      this.treeDx = {
-        client: publicClient,
-        graph: publicGraph,
-        registry: publicRegistry,
-        federated: publicFederated,
-        exec: publicExec,
-        artifact: publicArtifact
-      };
-      this.ports = {
-        repository: new TreeDxRepositoryPort(publicClient),
-        query: new TreeDxRepositoryQueryPort(publicClient),
-        graph: new TreeDxGraphPort(publicGraph),
-        registry: publicRegistry ? new TreeDxRegistryPort(publicRegistry) : void 0,
-        federated: publicFederated ? new TreeDxFederatedPort(publicFederated) : void 0,
-        exec: publicExec,
-        artifact: publicArtifact
-      };
-    } else if (rawTreeDxOptions?.client) {
-      const publicClient = rawTreeDxOptions.client instanceof PublicTreeDxClient ? rawTreeDxOptions.client : new PublicTreeDxClient(rawTreeDxOptions.client);
-      const publicGraph = new TreeDxGraphAdapter({
-        client: publicClient,
-        repoId: rawTreeDxOptions.repoId,
-        defaultRef: rawTreeDxOptions.ref
-      });
-      const publicExec = new TreeDxExecPort(publicClient);
-      const publicArtifact = new TreeDxArtifactPort(publicClient);
-      this.content = new MissingTreeDxContentBackend();
-      this.graph = new LocalGraphBackend(this.localGraphRuntime);
-      this.treeDx = {
-        client: publicClient,
-        graph: publicGraph,
-        exec: publicExec,
-        artifact: publicArtifact
-      };
-      this.ports = {
-        repository: new TreeDxRepositoryPort(publicClient),
-        query: new TreeDxRepositoryQueryPort(publicClient),
-        graph: new TreeDxGraphPort(publicGraph),
-        exec: publicExec,
-        artifact: publicArtifact
-      };
-    } else {
-      this.content = new MissingTreeDxContentBackend();
-      this.graph = new LocalGraphBackend(this.localGraphRuntime);
-      this.ports = {
-        repository: new LocalRepositoryPort(this.localContentStore),
-        query: new LocalRepositoryQueryPort(this.localContentStore),
-        graph: new LocalGraphPort(this.localGraphRuntime)
-      };
-    }
-    this.dispatchConfig = options.dispatch;
-  }
-  static createLocal(options = {}) {
-    const repoRoot = resolveSdkRepoRoot(options.repoRoot);
-    const d1 = new NodeSqliteD1Database(options.persistTo ?? options.databaseName ?? ".treeseed/generated/environments/local/site-data.sqlite");
-    return new AgentSdk({
-      repoRoot,
-      database: new CloudflareD1AgentDatabase(d1),
-      models: options.models,
-      modelRegistry: options.modelRegistry,
-      contentRepository: options.contentRepository,
-      treeDx: options.treeDx,
-      dispatch: options.dispatch
-    });
-  }
-  async resolveDispatchToken(source) {
-    if (!source) {
-      return null;
-    }
-    if (source.type === "bearer") {
-      return source.token;
-    }
-    return await source.resolveToken();
-  }
-  async executeDispatchLocally(request) {
-    const namespace = request.namespace ?? "sdk";
-    if (namespace === "workflow") {
-      const operations = new TreeseedOperationsSdk();
-      return operations.execute({
-        operationName: request.operation,
-        input: request.input ?? {}
-      }, {
-        cwd: this.repoRoot,
-        env: process.env,
-        transport: "sdk"
-      });
-    }
-    if (this.content instanceof MissingTreeDxContentBackend) {
-      const input = request.input ?? {};
-      if (request.operation === "read" || request.operation === "get") {
-        const definition = resolveModelDefinition(input.model, this.models);
-        const payload = await this.localContentStore.get({
-          ...input,
-          model: definition.name
-        });
-        return this.envelope(definition.name, request.operation === "read" ? "read" : "get", payload);
-      }
-      if (request.operation === "search") {
-        const definition = resolveModelDefinition(input.model, this.models);
-        const payload = await this.localContentStore.search({
-          ...input,
-          model: definition.name
-        });
-        return this.envelope(definition.name, "search", payload, {
-          count: payload.length
-        });
-      }
-    }
-    return executeSdkOperation(this, request.operation, request.input ?? {});
-  }
-  async dispatch(request) {
-    const namespace = request.namespace ?? "sdk";
-    const capability = findDispatchCapability(namespace, request.operation);
-    if (!capability) {
-      throw new Error(`Unknown dispatch operation "${namespace}:${request.operation}".`);
-    }
-    const preferredMode = request.preferredMode ?? this.dispatchConfig?.policy ?? capability.defaultDispatchMode;
-    const dispatchConfig = this.dispatchConfig;
-    if (!dispatchConfig && preferredMode === "remote_only") {
-      throw new Error(`Dispatch for "${namespace}:${request.operation}" requires a remote market configuration.`);
-    }
-    const shouldStayLocal = capability.executionClass === "local_only" || !dispatchConfig || preferredMode === "prefer_local";
-    if (shouldStayLocal) {
-      return {
-        ok: true,
-        mode: "inline",
-        namespace,
-        operation: request.operation,
-        target: "local",
-        capability,
-        payload: await this.executeDispatchLocally({ ...request, namespace })
-      };
-    }
-    const token = await this.resolveDispatchToken(dispatchConfig.credentialSource);
-    const client = new RemoteTreeseedDispatchClient(new RemoteTreeseedClient({
-      hosts: [{ id: "market", baseUrl: dispatchConfig.marketBaseUrl }],
-      activeHostId: "market",
-      auth: token ? { accessToken: token } : void 0
-    }, {
-      fetchImpl: dispatchConfig.fetchImpl
-    }));
-    return client.dispatch(dispatchConfig.projectId, {
-      ...request,
-      namespace,
-      preferredMode
-    });
-  }
-  envelope(model, operation, payload, meta) {
-    return {
-      ok: true,
-      model: resolveModelDefinition(model, this.models).name,
-      operation,
-      payload,
-      meta
-    };
-  }
-  async get(request) {
-    const definition = resolveModelDefinition(request.model, this.models);
-    const payload = definition.storage === "content" ? await this.content.get({ ...request, model: definition.name }) : await this.database.get({ ...request, model: definition.name });
-    return this.envelope(definition.name, "get", payload);
-  }
-  read(request) {
-    return this.get(request).then((response) => ({
-      ...response,
-      operation: "read"
-    }));
-  }
-  async search(request) {
-    const definition = resolveModelDefinition(request.model, this.models);
-    const payload = definition.storage === "content" ? await this.content.search({ ...request, model: definition.name }) : await this.database.search({ ...request, model: definition.name });
-    return this.envelope(definition.name, "search", payload, {
-      count: Array.isArray(payload) ? payload.length : 0
-    });
-  }
-  async follow(request) {
-    const definition = resolveModelDefinition(request.model, this.models);
-    const payload = definition.storage === "content" ? await this.content.follow({ ...request, model: definition.name }) : await this.database.follow({ ...request, model: definition.name });
-    return this.envelope(definition.name, "follow", payload, {
-      count: payload.items.length
-    });
-  }
-  async pick(request) {
-    const definition = resolveModelDefinition(request.model, this.models);
-    const payload = definition.storage === "content" ? await this.localContentStore.pick({ ...request, model: definition.name }) : await this.database.pick({ ...request, model: definition.name });
-    return this.envelope(definition.name, "pick", payload, {
-      claimed: Boolean(payload.item)
-    });
-  }
-  async create(request) {
-    const definition = resolveModelDefinition(request.model, this.models);
-    const payload = definition.storage === "content" ? await this.content.create({ ...request, model: definition.name }) : await this.database.create({ ...request, model: definition.name });
-    return this.envelope(definition.name, "create", payload);
-  }
-  async update(request) {
-    const definition = resolveModelDefinition(request.model, this.models);
-    const payload = definition.storage === "content" ? await this.content.update({ ...request, model: definition.name }) : await this.database.update({ ...request, model: definition.name });
-    return this.envelope(definition.name, "update", payload);
-  }
-  async claimMessage(request) {
-    const payload = await this.database.claimMessage(request);
-    return this.envelope("message", "pick", payload, {
-      claimed: Boolean(payload)
-    });
-  }
-  async ackMessage(request) {
-    await this.database.ackMessage(request);
-    return this.envelope("message", "update", { id: request.id, status: request.status });
-  }
-  async createMessage(request) {
-    const payload = await this.database.createMessage(request);
-    return this.envelope("message", "create", payload);
-  }
-  async recordRun(request) {
-    const payload = await this.database.recordRun(request);
-    return this.envelope("agent_run", "update", payload);
-  }
-  async getCursor(request) {
-    const payload = await this.database.getCursor(request);
-    return this.envelope("agent_cursor", "get", payload);
-  }
-  async upsertCursor(request) {
-    await this.database.upsertCursor(request);
-    return this.envelope("agent_cursor", "update", request);
-  }
-  async releaseLease(request) {
-    await this.database.releaseLease(request);
-    return this.envelope("content_lease", "update", request);
-  }
-  async releaseAllLeases() {
-    const count = await this.database.releaseAllLeases();
-    return this.envelope("content_lease", "update", { count });
-  }
-  async startWorkDay(request) {
-    const payload = await this.database.startWorkDay(request);
-    return this.envelope("work_day", "create", payload);
-  }
-  async closeWorkDay(request) {
-    const payload = await this.database.closeWorkDay(request);
-    return this.envelope("work_day", "update", payload);
-  }
-  async createReport(request) {
-    const payload = await this.database.createReport(request);
-    return this.envelope("report", "create", payload);
-  }
-  async getWorkPolicy(projectId, environment = "local") {
-    const payload = await this.database.getWorkPolicy(projectId, environment);
-    return this.envelope("work_day", "get", payload);
-  }
-  async upsertWorkPolicy(request) {
-    const payload = await this.database.upsertWorkPolicy(request);
-    return this.envelope("work_day", "update", payload);
-  }
-  async createWorkdayRequest(request) {
-    const payload = await this.database.createWorkdayRequest(request);
-    return this.envelope("workday_request", "create", payload);
-  }
-  async listWorkdayRequests(projectId, environment, state) {
-    const payload = await this.database.listWorkdayRequests(projectId, environment, state);
-    return this.envelope("workday_request", "search", payload, { count: payload.length });
-  }
-  async createTask(request) {
-    const payload = await this.database.createTask(request);
-    return this.envelope("task", "create", payload);
-  }
-  async claimTask(request) {
-    const payload = await this.database.claimTask(request);
-    return this.envelope("task", "pick", payload);
-  }
-  async recordTaskProgress(request) {
-    const payload = await this.database.recordTaskProgress(request);
-    return this.envelope("task", "update", payload);
-  }
-  async completeTask(request) {
-    const payload = await this.database.completeTask(request);
-    return this.envelope("task", "update", payload);
-  }
-  async getManagerContext(taskId) {
-    const payload = await this.database.getManagerContext(taskId);
-    return this.envelope("task", "get", payload);
-  }
-  async claimWorkdayManagerLease(request) {
-    const payload = await this.database.claimWorkdayManagerLease(request);
-    return this.envelope("workday_manager_lease", "claim", payload);
-  }
-  async releaseWorkdayManagerLease(request) {
-    const payload = await this.database.releaseWorkdayManagerLease(request);
-    return this.envelope("workday_manager_lease", "release", payload);
-  }
-  async listWorkdayManagerLeases(projectId, environment) {
-    const payload = await this.database.listWorkdayManagerLeases(projectId, environment);
-    return this.envelope("workday_manager_lease", "search", payload, { count: payload.length });
-  }
-  async recordWorkerRunner(request) {
-    const payload = await this.database.recordWorkerRunner(request);
-    return this.envelope("worker_runner", "update", payload);
-  }
-  async listWorkerRunners(projectId, environment) {
-    const payload = await this.database.listWorkerRunners(projectId, environment);
-    return this.envelope("worker_runner", "search", payload, { count: payload.length });
-  }
-  async recordRepositoryClaim(request) {
-    const payload = await this.database.recordRepositoryClaim(request);
-    return this.envelope("repository_claim", "update", payload);
-  }
-  async listRepositoryClaims(projectId, repositoryId) {
-    const payload = await this.database.listRepositoryClaims(projectId, repositoryId);
-    return this.envelope("repository_claim", "search", payload, { count: payload.length });
-  }
-  async recordRunnerScaleDecision(request) {
-    const payload = await this.database.recordRunnerScaleDecision(request);
-    return this.envelope("runner_scale_decision", "create", payload);
-  }
-  async listRunnerScaleDecisions(projectId, environment, workDayId) {
-    const payload = await this.database.listRunnerScaleDecisions(projectId, environment, workDayId);
-    return this.envelope("runner_scale_decision", "search", payload, { count: payload.length });
-  }
-  async updateWorkDayGraph(request) {
-    const payload = await this.database.updateWorkDayGraph(request);
-    return this.envelope("work_day", "update", payload);
-  }
-  async listPriorityOverrides(projectId) {
-    const payload = await this.database.listPriorityOverrides(projectId);
-    return this.envelope("task", "search", payload, { count: payload.length });
-  }
-  async upsertPriorityOverride(request) {
-    const payload = await this.database.upsertPriorityOverride(request);
-    return this.envelope("task", "update", payload);
-  }
-  async createPrioritySnapshot(request) {
-    const payload = await this.database.createPrioritySnapshot(request);
-    return this.envelope("report", "create", payload);
-  }
-  async getLatestPrioritySnapshot(projectId, workDayId) {
-    const payload = await this.database.getLatestPrioritySnapshot(projectId, workDayId);
-    return this.envelope("report", "get", payload);
-  }
-  async recordTaskCredits(request) {
-    const payload = await this.database.recordTaskCredits(request);
-    return this.envelope("report", "create", payload);
-  }
-  async listTaskCredits(workDayId) {
-    const payload = await this.database.listTaskCredits(workDayId);
-    return this.envelope("report", "search", payload, { count: payload.length });
-  }
-  async recordScaleDecision(request) {
-    const payload = await this.database.recordScaleDecision(request);
-    return this.envelope("report", "create", payload);
-  }
-  async getLatestScaleDecision(projectId, environment, poolName) {
-    const payload = await this.database.getLatestScaleDecision(projectId, environment, poolName);
-    return this.envelope("report", "get", payload);
-  }
-  async createApprovalRequest(request) {
-    const payload = await this.database.createApprovalRequest(request);
-    return this.envelope("approval_request", "create", payload);
-  }
-  async listApprovalRequests(request = {}) {
-    const payload = await this.database.listApprovalRequests(request);
-    return this.envelope("approval_request", "search", payload, { count: payload.length });
-  }
-  async decideApprovalRequest(id, request) {
-    const payload = await this.database.decideApprovalRequest(id, request);
-    return this.envelope("approval_request", "update", payload);
-  }
-  async upsertTeamInboxItem(request) {
-    const payload = await this.database.upsertTeamInboxItem(request);
-    return this.envelope("team_inbox_item", "update", payload);
-  }
-  async listWorkstreams(projectId) {
-    const payload = await this.database.listWorkstreams(projectId);
-    return this.envelope("task", "search", payload, { count: payload.length });
-  }
-  async getWorkstream(workstreamId) {
-    const payload = await this.database.getWorkstream(workstreamId);
-    return this.envelope("task", "get", payload);
-  }
-  async upsertWorkstream(input) {
-    const payload = await this.database.upsertWorkstream(input);
-    return this.envelope("task", "update", payload);
-  }
-  async appendWorkstreamEvent(input) {
-    const payload = await this.database.appendWorkstreamEvent(input);
-    return this.envelope("workstream_event", "create", payload);
-  }
-  async listReleases(projectId) {
-    const payload = await this.database.listReleases(projectId);
-    return this.envelope("report", "search", payload, { count: payload.length });
-  }
-  async getRelease(releaseId) {
-    const payload = await this.database.getRelease(releaseId);
-    return this.envelope("report", "get", payload);
-  }
-  async upsertRelease(input) {
-    const payload = await this.database.upsertRelease(input);
-    return this.envelope("report", "update", payload);
-  }
-  async listSharePackages(projectId) {
-    const payload = await this.database.listSharePackages(projectId);
-    return this.envelope("report", "search", payload, { count: payload.length });
-  }
-  async getSharePackage(packageId) {
-    const payload = await this.database.getSharePackage(packageId);
-    return this.envelope("report", "get", payload);
-  }
-  async upsertSharePackage(input) {
-    const payload = await this.database.upsertSharePackage(input);
-    return this.envelope("report", "update", payload);
-  }
-  async listAgentSpecs(options) {
-    const rawEntries = await this.listRawAgentSpecs(options);
-    return rawEntries.map((entry) => normalizeAgentSpec(entry)).filter((entry) => Boolean(entry && entry.slug));
-  }
-  async listRawAgentSpecs(options) {
-    const filters = typeof options?.enabled === "boolean" ? [{ field: "enabled", op: "eq", value: options.enabled }] : [];
-    const response = await this.search({
-      model: "agent",
-      filters,
-      sort: [{ field: "name", direction: "asc" }]
-    });
-    return response.payload;
-  }
-  scopeForAgent(agent) {
-    return new ScopedAgentSdk(this, agent.slug, agent.permissions);
-  }
-  /** Advanced graph maintenance helper. Most application code should use parseGraphDsl() -> queryGraph() -> buildContextPack(). */
-  refreshGraph(request) {
-    return this.graph.refresh(request);
-  }
-  /** Advanced lexical graph primitive for file nodes. Prefer queryGraph() or buildContextPack() for AI-context retrieval. */
-  searchFiles(query, options) {
-    return this.localGraphRuntime.searchFiles(query, options);
-  }
-  /** Advanced lexical graph primitive for section nodes. Prefer queryGraph() or buildContextPack() for AI-context retrieval. */
-  searchSections(query, options) {
-    return this.localGraphRuntime.searchSections(query, options);
-  }
-  /** Advanced lexical graph primitive for entity nodes. Prefer queryGraph() or buildContextPack() for AI-context retrieval. */
-  searchEntities(query, options) {
-    return this.localGraphRuntime.searchEntities(query, options);
-  }
-  /** Advanced graph primitive that returns one raw graph node by id. */
-  getGraphNode(id) {
-    return this.localGraphRuntime.getNode(id);
-  }
-  /** Advanced graph primitive for direct neighborhood inspection. Prefer queryGraph() for ranked retrieval. */
-  getNeighbors(id, options) {
-    return this.localGraphRuntime.getNeighbors(id, options);
-  }
-  /** Advanced traversal primitive for direct reference walking. Prefer queryGraph() when you need ranking and ctx-aware behavior. */
-  followReferences(id, options) {
-    return this.localGraphRuntime.followReferences(id, options);
-  }
-  /** Advanced graph primitive for incoming-link inspection. */
-  getBacklinks(id, options) {
-    return this.localGraphRuntime.getBacklinks(id, options);
-  }
-  /** Advanced graph primitive for local relatedness. Prefer queryGraph() for the primary ranked graph workflow. */
-  getRelated(id, options) {
-    return this.localGraphRuntime.getRelated(id, options);
-  }
-  /** Advanced traversal primitive for raw subgraph extraction. Prefer buildContextPack() when you need prompt-ready output. */
-  getSubgraph(seedIds, options) {
-    return this.localGraphRuntime.getSubgraph(seedIds, options);
-  }
-  /** Primary graph workflow helper. Resolves roots before ranking and traversal. */
-  resolveSeeds(request) {
-    return this.localGraphRuntime.resolveSeeds(request);
-  }
-  /** Primary graph workflow entrypoint for ranked graph retrieval. */
-  queryGraph(request) {
-    return this.graph.queryGraph(request);
-  }
-  /** Primary graph workflow entrypoint for prompt-ready AI context assembly. */
-  buildContextPack(request) {
-    return this.graph.buildContextPack(request);
-  }
-  /** Primary graph workflow helper. Parses the public ctx DSL into a typed graph request. */
-  parseGraphDsl(source) {
-    return this.graph.parseGraphDsl(source);
-  }
-  /** Primary graph workflow helper for resolving ids, paths, and anchors into graph nodes. */
-  resolveReference(reference, options) {
-    return this.localGraphRuntime.resolveReference(reference, options);
-  }
-  /** Primary graph workflow helper for explaining why two nodes are connected. */
-  explainReferenceChain(fromId, toId) {
-    return this.localGraphRuntime.explainReferenceChain(fromId, toId);
-  }
-}
-class ScopedAgentSdk {
-  constructor(base, actor, permissions) {
-    this.base = base;
-    this.actor = actor;
-    this.permissions = permissions;
-  }
-  base;
-  actor;
-  permissions;
-  assertAllowed(model, operation) {
-    const normalized = resolveModelDefinition(model, this.base.models).name;
-    if (!operationAllowed(this.permissions, normalized, operation)) {
-      throw new Error(`Agent "${this.actor}" is not allowed to ${operation} ${normalized}.`);
-    }
-  }
-  allowedModelsFor(operation) {
-    return this.permissions.filter((permission) => permission.operations.map(normalizeOperation).includes(normalizeOperation(operation))).map((permission) => resolveModelDefinition(permission.model, this.base.models).name);
-  }
-  async assertGraphNodeAllowed(id, operation) {
-    const node = await this.base.getGraphNode(id);
-    if (!node?.sourceModel) {
-      return node;
-    }
-    const allowedOps = operation === "get" ? ["search", "follow"] : [operation];
-    const permitted = allowedOps.some((op) => this.allowedModelsFor(op).includes(node.sourceModel));
-    if (!permitted) {
-      throw new Error(`Agent "${this.actor}" is not allowed to ${operation} graph node ${id}.`);
-    }
-    return node;
-  }
-  get(request) {
-    this.assertAllowed(request.model, "get");
-    return this.base.get(request);
-  }
-  read(request) {
-    this.assertAllowed(request.model, "read");
-    return this.base.read(request);
-  }
-  search(request) {
-    this.assertAllowed(request.model, "search");
-    return this.base.search(request);
-  }
-  follow(request) {
-    this.assertAllowed(request.model, "follow");
-    return this.base.follow(request);
-  }
-  pick(request) {
-    this.assertAllowed(request.model, "pick");
-    return this.base.pick(request);
-  }
-  create(request) {
-    this.assertAllowed(request.model, "create");
-    return this.base.create({
-      ...request,
-      actor: this.actor
-    });
-  }
-  update(request) {
-    this.assertAllowed(request.model, "update");
-    return this.base.update({
-      ...request,
-      actor: this.actor
-    });
-  }
-  claimMessage(request) {
-    this.assertAllowed("message", "pick");
-    return this.base.claimMessage(request);
-  }
-  ackMessage(request) {
-    this.assertAllowed("message", "update");
-    return this.base.ackMessage(request);
-  }
-  createMessage(request) {
-    this.assertAllowed("message", "create");
-    return this.base.createMessage({
-      ...request,
-      actor: this.actor
-    });
-  }
-  recordRun(request) {
-    return this.base.recordRun(request);
-  }
-  getCursor(request) {
-    return this.base.getCursor(request);
-  }
-  upsertCursor(request) {
-    return this.base.upsertCursor(request);
-  }
-  releaseLease(request) {
-    return this.base.releaseLease(request);
-  }
-  releaseAllLeases() {
-    return this.base.releaseAllLeases();
-  }
-  refreshGraph(request) {
-    return this.base.refreshGraph(request);
-  }
-  /** Advanced lexical graph primitive for file nodes. Scoped to models the agent may search. */
-  searchFiles(query, options) {
-    const allowedModels = this.allowedModelsFor("search");
-    return this.base.searchFiles(query, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  /** Advanced lexical graph primitive for section nodes. Scoped to models the agent may search. */
-  searchSections(query, options) {
-    const allowedModels = this.allowedModelsFor("search");
-    return this.base.searchSections(query, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  /** Advanced lexical graph primitive for entity nodes. Scoped to models the agent may search. */
-  searchEntities(query, options) {
-    const allowedModels = this.allowedModelsFor("search");
-    return this.base.searchEntities(query, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  async getGraphNode(id) {
-    return this.assertGraphNodeAllowed(id, "get");
-  }
-  async getNeighbors(id, options) {
-    await this.assertGraphNodeAllowed(id, "follow");
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.getNeighbors(id, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  async followReferences(id, options) {
-    await this.assertGraphNodeAllowed(id, "follow");
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.followReferences(id, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  async getBacklinks(id, options) {
-    await this.assertGraphNodeAllowed(id, "follow");
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.getBacklinks(id, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  async getRelated(id, options) {
-    await this.assertGraphNodeAllowed(id, "follow");
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.getRelated(id, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  getSubgraph(seedIds, options) {
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.getSubgraph(seedIds, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  /** Primary graph workflow helper, scoped to followable models. */
-  resolveSeeds(request) {
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.resolveSeeds({
-      ...request,
-      options: { ...request.options, models: request.options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels }
-    });
-  }
-  /** Primary graph workflow entrypoint for ranked graph retrieval, scoped to followable models. */
-  queryGraph(request) {
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.queryGraph({
-      ...request,
-      options: { ...request.options, models: request.options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels }
-    });
-  }
-  /** Primary graph workflow entrypoint for prompt-ready context assembly, scoped to followable models. */
-  buildContextPack(request) {
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.buildContextPack({
-      ...request,
-      options: { ...request.options, models: request.options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels }
-    });
-  }
-  parseGraphDsl(source) {
-    return this.base.parseGraphDsl(source);
-  }
-  resolveReference(reference, options) {
-    const allowedModels = this.allowedModelsFor("follow");
-    return this.base.resolveReference(reference, { ...options, models: options?.models?.filter((model) => allowedModels.includes(model)) ?? allowedModels });
-  }
-  explainReferenceChain(fromId, toId) {
-    return Promise.all([
-      this.assertGraphNodeAllowed(fromId, "follow"),
-      this.assertGraphNodeAllowed(toId, "follow")
-    ]).then(() => this.base.explainReferenceChain(fromId, toId));
-  }
-}
-export {
-  AgentSdk,
-  ScopedAgentSdk
-};