common-qa-mcp 0.2.0 → 0.3.0

package/dist/adapters/types.d.ts

@@ -1,4 +1,4 @@
-import type { ActionDef, CloudRunner, DatasetInfo, EntityRef, EnvInfo, JournalOp, JournalView, MemberOp, ObjectQuery, ProjectSummary, QaObject, RunOptions, RunRef, RunStatus, RunTarget, SavedRef, Story, StoryQuery, StorySummary, Suite, SuiteSummary, TcQuery, TcSummary, TestCase } from '../domain/types.js';
+import type { ActionDef, CloudRunner, DatasetInfo, DefaultIteration, Formula, FormulaCall, SaveGeneratedIterations, SaveGeneratedIterationsResult, EntityRef, EnvInfo, JournalOp, JournalView, LocalAgent, MemberOp, ModuleSummary, ObjectQuery, ProjectSummary, QaObject, ReleaseQuery, ReleaseSummary, SprintQuery, SprintSummary, RunOptions, RunRef, RunStatus, RunTarget, ScheduleAction, ScheduleInfo, ScheduleOptions, ScheduleRef, ScheduleUpdate, SavedRef, Story, StoryQuery, StorySummary, Suite, SuiteSummary, TcQuery, TcSummary, TestCase } from '../domain/types.js';
 export type ProjectInfo = {
     provider: 'walnut' | 'simplifyqa';
     projectId: string;
@@ -48,13 +48,37 @@ export interface ProviderAdapter {
      *  Mongo _id or a US_/Jira business key. Optional: only products with a story backlog implement them. */
     listStories?(q: StoryQuery): Promise<StorySummary[]>;
     getStory?(id: string): Promise<Story>;
+    /** SimplifyQA-only: modules / folders in the test-case tree, so a draft can be filed under a
+     *  chosen module on save. Absent on providers with no module tree (Walnut). */
+    listModules?(): Promise<ModuleSummary[]>;
+    /** RELEASES & SPRINTS — SimplifyQA project-management surface. `listReleases({scope})` returns
+     *  releases for the current project (`scope:'project'`) or every release the token can see
+     *  (`scope:'all'`); the tool ASKS the user which. `listSprints({releaseId?})` optionally filters
+     *  by release. Absent on providers with no release/sprint model (Walnut). */
+    listReleases?(q: ReleaseQuery): Promise<ReleaseSummary[]>;
+    listSprints?(q: SprintQuery): Promise<SprintSummary[]>;
     startRun(target: RunTarget, opts: RunOptions): Promise<RunRef>;
+    /** Create a SCHEDULE (deferred / recurring run) instead of dispatching now. Optional: only products
+     *  with a scheduler implement it; absence = "this provider cannot schedule runs". */
+    createSchedule?(target: RunTarget, opts: ScheduleOptions): Promise<ScheduleRef>;
+    /** List the project's schedules for management (find one to edit / cancel / delete). Optional. */
+    listSchedules?(): Promise<ScheduleInfo[]>;
+    /** Edit a schedule's cadence / time / browser / pinned agent. Optional. Reads the current
+     *  update_version itself (optimistic concurrency), so the caller passes only what changes. */
+    updateSchedule?(scheduleId: string, changes: ScheduleUpdate): Promise<ScheduleRef>;
+    /** Pause / resume / cancel a schedule (reversible pause↔resume; cancel stops the pending/live run). */
+    controlSchedule?(scheduleId: string, action: ScheduleAction): Promise<ScheduleRef>;
+    /** Delete a schedule permanently (also tears down any live run it owns). Optional. */
+    deleteSchedule?(scheduleId: string): Promise<void>;
     /** Per-step results when terminal. */
     getRun(runId: string): Promise<RunStatus>;
     stopRun(runId: string): Promise<void>;
     /** Cloud runner VMs registered to the project, with online status. Optional: only products with a
      *  cloud-execution fabric implement it; absence = "this provider has no cloud runners". */
     listCloudRunners?(): Promise<CloudRunner[]>;
+    /** LOCAL agents registered to the project, with online status. Optional: only products with a local
+     *  agent fabric implement it; absence = "this provider has no local agents to pick". */
+    listLocalAgents?(): Promise<LocalAgent[]>;
     /** Passthrough for AGENT-BOUND tools (recording/browser) the Common MCP proxies rather than wraps.
      *  Only the remote-MCP forwarder implements these; `unknown` is a CallToolResult (kept SDK-free
      *  here). */
@@ -69,6 +93,29 @@ export interface ProviderAdapter {
     listEnvironments(): Promise<EnvInfo[]>;
     /** Walnut-first. */
     listDatasets?(tcId?: string): Promise<DatasetInfo[]>;
+    /** Fetch the default (template) iteration row for a testcase — the seed used by
+     *  `tc_generate_testdata` to learn the paramId map and infer types. Forwards to the product MCP's
+     *  `get_default_iteration` provider-op. Absent on providers without a testdata store. */
+    getDefaultIteration?(q: {
+        tcId: string;
+        versionId?: string;
+        environmentType?: string;
+    }): Promise<DefaultIteration>;
+    /** Persist N generated iteration rows for a testcase in one call. Forwards to the product MCP's
+     *  `save_generated_iterations` provider-op (backed by `/tm/testdata/saveItrForDataGen`). */
+    saveGeneratedIterations?(payload: SaveGeneratedIterations): Promise<SaveGeneratedIterationsResult>;
+    /** List formulas the current project can use for testdata generation — DEFAULT prefabs (customer-
+     *  wide) plus CUSTOM formulas (customer- or project-scoped). Powers `tc_list_formulas` and the
+     *  per-column formula options that `tc_generate_testdata` accepts. Absent on providers with no
+     *  formulas store. */
+    listFormulas?(): Promise<Formula[]>;
+    /** Evaluate one formula call via the product's compute endpoint. Returns the generated `value`
+     *  string plus a canonical `expression` (`=NAME("a","b")`) suitable for stamping onto a testdata
+     *  row cell's `formulaValue` — matching the format the UI persists. */
+    evaluateFormula?(call: FormulaCall): Promise<{
+        value: string;
+        expression: string;
+    }>;
     /** Full locator bag; needed by migration (§7A). */
     getObject?(id: string): Promise<QaObject>;
     /** Deep link into product UI. */

package/dist/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,SAAS,EACT,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,EACd,QAAQ,EACR,UAAU,EACV,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,KAAK,EACL,UAAU,EACV,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,OAAO,EACP,SAAS,EACT,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IAGpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7B,sFAAsF;IACtF,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE1C,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD,+BAA+B;IAC/B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,0BAA0B;IAC1B,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,uCAAuC;IACvC,aAAa,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9D,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7C,qEAAqE;IACrE,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAExD;;+CAE2C;IAC3C,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjD;wFACoF;IACpF,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnE,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAChE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;6GACyG;IACzG,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEtC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,sCAAsC;IACtC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;+FAC2F;IAC3F,gBAAgB,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE5C;;iBAEa;IACb,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE;0EACsE;IACtE,cAAc,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IAEjH,gBAAgB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,oBAAoB;IACpB,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,mDAAmD;IACnD,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1C,iCAAiC;IACjC,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;CAC1C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"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"}

package/dist/adapters/walnut/adapter.d.ts

@@ -0,0 +1,231 @@
+import type { ConnectedQaConfig } from '../../config.js';
+import type { MakeClientOptions } from '../http.js';
+import type { ProjectInfo } from '../types.js';
+import type { ActionDef, CloudRunner, EntityRef, JournalOp, JournalView, LocalAgent, MemberOp, ProjectSummary, RunOptions, RunRef, RunStatus, RunTarget, ScheduleAction, ScheduleInfo, ScheduleOptions, ScheduleRef, ScheduleUpdate, SavedRef, Story, StoryQuery, StorySummary, Suite, SuiteSummary, TcQuery, TcSummary, TestCase } from '../../domain/types.js';
+/**
+ * Transport-only injection seam for tests: swap the underlying fetch implementation
+ * instead of mutating `globalThis`. The adapter still builds its own `QaHttp` via
+ * `makeClient` (so its real `headers()` logic always runs, jwt vs key mode included)
+ * -- only the network transport is replaceable.
+ */
+export type WalnutTransport = Pick<MakeClientOptions, 'fetchImpl' | 'FormDataImpl' | 'BlobImpl'>;
+/**
+ * WalnutAdapter — DIRECT-to-backend REST driver for Walnut (design note §3/§4). Every data op
+ * (discover / author / save / run-dispatch / triage) hits the Walnut backend REST directly via a
+ * `QaHttp` bound to `cfg.baseUrl` (the BACKEND base, `QA_BASE_URL`) — so a cloud editor with no local
+ * agent can drive the whole lifecycle. The ONLY agent-bound surface is recording + save-with-editor,
+ * which hops to the LOCAL AGENT's `/mcp` (`cfg.url`, `QA_MCP_URL`) via a lazily-built RemoteMcpAdapter
+ * (see `callRaw`/`listAgentTools`); when `cfg.url` is unset, recording is gracefully unavailable.
+ *
+ * This class deliberately does not `implements ProviderAdapter` — it ports only the direct-REST subset
+ * (journal, objects, environments, suite create/delete are out of scope here); the factory casts it,
+ * and no registered tool calls the unported methods.
+ */
+export declare class WalnutAdapter {
+    private readonly cfg;
+    private readonly http;
+    /** Lazily-built hop to the LOCAL AGENT's /mcp (cfg.url) for the agent-bound recording surface. Only
+     *  ever built when cfg.url is set; direct REST never uses it. */
+    private agentHop;
+    constructor(cfg: ConnectedQaConfig, transport?: WalnutTransport);
+    private headers;
+    /** Validates baseUrl+token+project (`GET /api/projects/:id`). */
+    info(): Promise<ProjectInfo>;
+    /** Projects visible to the token (`GET /api/projects`). Tolerant of both an array body and a
+     *  `{ projects: [...] }` wrapper. */
+    listProjects(): Promise<ProjectSummary[]>;
+    listTestCases(q: TcQuery): Promise<TcSummary[]>;
+    /** Neutral, steps included. `id` accepts either a Mongo ObjectId or a `TC_xxx` business key. */
+    getTestCase(id: string): Promise<TestCase>;
+    /** List the project's test suites (`GET /api/test-suites`). `skip_filters=true` skips the faceted
+     *  filter-metadata queries we don't need. Excludes ad-hoc suites server-side. `id` is the Mongo
+     *  `_id` (what getSuite resolves by). */
+    listSuites(): Promise<SuiteSummary[]>;
+    /** Read one suite with its ordered members (`GET /api/test-suites/:id`). `id` is the Mongo `_id`
+     *  (the route does NOT accept the `SU_` business key). */
+    getSuite(id: string): Promise<Suite>;
+    /** List the project's USER STORIES (`GET /api/stories?type=story`), for the story-driven authoring
+     *  flow. `search` is a case-insensitive regex over key/title/description/AC (backend SEC-07 escaped).
+     *  `id` on each row is the Mongo `_id` (what a test case links to via story_id). */
+    listStories(q: StoryQuery): Promise<StorySummary[]>;
+    /** Read one user story with its acceptance criteria. `GET /api/stories/:id` resolves by Mongo `_id`
+     *  ONLY (no business-key route), so a `US_123`/Jira key is resolved first via the list `search`
+     *  endpoint, matching key/walnut_key. */
+    getStory(id: string): Promise<Story>;
+    /** Resolve a story reference to its Mongo `_id`. A 24-hex id passes straight through; a business key
+     *  (US_123 / an external Jira key) is looked up via `GET /api/stories?search=` and matched on
+     *  key/walnut_key (there is no GET-by-key route). Throws a clear error when nothing matches. */
+    private resolveStoryMongoId;
+    /** Delete a test case (`DELETE /api/test-cases/:id`; recoverable via the product recycle bin). Like
+     *  the update PUT, the route resolves ONLY by Mongo _id, so a business key is resolved first. */
+    deleteTestCase(id: string): Promise<void>;
+    /**
+     * Add / remove suite members (`PATCH /api/test-suites/:id/test-cases`, one action per call). The
+     * neutral op names a `tcId`, but the two backend actions speak different keys:
+     *   • add    → `testCaseIds[]` of MONGO _ids (the route casts them to ObjectId), so each tcId is
+     *              resolved from a business key when needed. The backend appends with fresh instanceIds
+     *              and rejects mixing test-case categories (manual vs automated) in one suite (409).
+     *   • remove → a single `instanceId`. The suite stores instanceIds, not tcIds, so we map each
+     *              requested tcId (business key OR Mongo _id) to the instanceId(s) it occupies in the
+     *              CURRENT membership and remove each. Removing a tcId drops every instance of it.
+     * Returns the resulting neutral Suite. (reorder ops aren't surfaced as a tool; ignored here.)
+     */
+    updateSuiteMembers(id: string, ops: MemberOp[]): Promise<Suite>;
+    /**
+     * Persist a NEW test case (`POST /api/test-cases`). The body mirrors the product's create schema:
+     * the category field is `test_category` (NOT `category`); `status` defaults to 'draft' server-side
+     * so we omit it; steps go through `toWalnutStep`. project comes from the x-project-id header and
+     * the creator from the JWT, so neither is in the body.
+     *
+     * Two-step, exactly like the UI: create the test case (the backend auto-creates a dataset with a
+     * column per `${param}` token and an EMPTY datarow), then fill that datarow via the SAME
+     * /api/test-data endpoint the Test Data tab uses. This keeps web value-handling in the MCP (no
+     * backend change) — walnut stores web values as `${param}` + datarow, never inline on the step.
+     */
+    createTestCase(tc: TestCase): Promise<SavedRef>;
+    /**
+     * Populate the datarow(s) of the dataset Walnut auto-creates from a test case's `${param}` tokens
+     * — the same second step the UI's Test Data tab performs (create leaves the columns empty). Values
+     * are keyed by PARAM NAME (the `${...}` token), which is how walnut stores them
+     * (prepareRowValuesForDb). No dataset linked (the test case had no `${param}` tokens) → no-op.
+     * Writes every seeded row (the create route makes one per project environment), merging over
+     * whatever the row already holds so nothing existing is clobbered.
+     */
+    private writeDefaultTestData;
+    /** Update an EXISTING test case, full-document (`PUT /api/test-cases/:id`). Sends the neutral
+     *  `version` for optimistic concurrency when present. */
+    updateTestCase(id: string, tc: TestCase): Promise<SavedRef>;
+    /** Neutral SavedRef from a create/update response, tolerant of the doc being bare or wrapped
+     *  (`{ testCase }` / `{ data }`). Prefers the business id (`test_case_id`) for the deep link. */
+    private savedRefFrom;
+    /**
+     * The credential of the ONLINE local agent for this project — the SAME one the UI's Run modal
+     * dispatches to. Sourced from the live roster (`GET /api/agent-credentials/project-agents`). The
+     * roster reflects real Redis/heartbeat presence, so `is_online` always targets a live poller.
+     * Returns null when the acting user has no online agent, OR when the roster endpoint is unreachable
+     * (e.g. the `ai-agents` feature flag is off) — the caller then surfaces a clear "no local agent"
+     * error. (The agent's cached-credential fallback is agent-only and intentionally not ported here.)
+     */
+    private resolveLocalAgentCredential;
+    /**
+     * Persist recorded elements into the Object Repository so a saved test case is EXECUTABLE.
+     *
+     * A recorded step carries `objectRef.locators` (real captured selectors) but no `objectRef.id` —
+     * it's a NEW object not yet in the repository. Walnut binds a step to its element via `object_id`
+     * (a repository row); it does NOT store locators inline on the step. So without this, the save
+     * drops every locator (object_id stays null) and the test case can't find its elements at run time.
+     *
+     * For each such step we POST /api/objects (description = the element name, attributes = the recorded
+     * locators verbatim — the executor reads them by name: `playwright` primary, `xpath_*` fallbacks)
+     * and stamp the returned `_id` onto `objectRef.id` so `toWalnutStep` then emits `object_id`. Runs
+     * BEFORE the test-case create, so a failure aborts cleanly with nothing half-saved (any objects
+     * already minted are just unlinked repository rows).
+     */
+    private ensureRecordedObjects;
+    /** A neutral tcId may be a business key (`TC_123`) or a Mongo `_id`; the executions API wants the
+     *  `_id`. 24-hex → pass through; otherwise resolve via the test-case read. */
+    private resolveTestcaseMongoId;
+    /**
+     * Start a run of ONE test case (`POST /api/executions/reserve`; reserve-first is the only path for
+     * cloud, and the modern path for local). mode:'local' dispatches to THIS agent's own queue (its
+     * cached agent credential); mode:'cloud' dispatches to the chosen online cloud runner. The backend
+     * mints the execution + enqueues; per-step driving happens on the agent/runner. `environment` is
+     * used only when it is already a Mongo id — otherwise the backend applies the project default env.
+     */
+    startRun(target: RunTarget, opts: RunOptions): Promise<RunRef>;
+    /**
+     * Start a SUITE run (`POST /api/executions/reserve` in suite mode — `testcase_ids[]` present).
+     * Fetches the suite's ordered members to build the parallel `testcase_ids`/`instance_ids` the
+     * reserve expects, then dispatches: mode:'local' → THIS agent's own queue (its online credential,
+     * which the backend requires for a local suite); mode:'cloud' → the chosen/auto-picked online
+     * runner. Returns the suite-run id (`SR_xxx`) as runId — getRun/stopRun route it back to the suite
+     * endpoints by that prefix.
+     */
+    private startSuiteRun;
+    /**
+     * Create a SCHEDULE — a deferred / recurring run — instead of dispatching now (`POST /api/schedules`,
+     * the same route the Scheduler UI uses). Maps the neutral target + ScheduleOptions to the backend's
+     * createScheduleSchema: schedule_target ('test_case' when a tcId is given, else 'suite'); tc_id /
+     * suite_id (the backend resolves a tc_id business key OR _id, but a suite_id must be a Mongo _id);
+     * execution_target ('local' | 'cloud_runner' from opts.mode); assigned_agent_credential_id (the
+     * picked local agent for local, or the picked cloud runner for cloud — omit to let the backend
+     * auto-pick a VM); scheduled_for (REQUIRED ISO); schedule_type (default 'once'); end_date; timezone
+     * (default 'UTC'); environment_id (only when a 24-hex id, mirroring startRun). MANUAL test cases are
+     * rejected server-side (MANUAL_NOT_SCHEDULABLE_CODE); unwrapApiError surfaces that message verbatim.
+     */
+    createSchedule(target: RunTarget, opts: ScheduleOptions): Promise<ScheduleRef>;
+    /** Map one raw schedule row (`GET /api/schedules`) to a neutral ScheduleInfo — human target + cadence
+     *  + status + pinned agent NAME (never the credential_id) + the update_version an edit must echo. */
+    private toScheduleInfo;
+    /** List the project's schedules for management (`GET /api/schedules`). */
+    listSchedules(): Promise<ScheduleInfo[]>;
+    /** Fetch one raw schedule row (via the list) — needed for its update_version before an edit. */
+    private fetchScheduleRaw;
+    /** Edit a schedule (`PUT /api/schedules/:id`). Reads the current update_version itself (optimistic
+     *  concurrency) so the caller passes only what changes. Re-pins via mode+agentId (local → also sets
+     *  execution_mode:'manual') or mode+cloudRunnerCredentialId (cloud), mirroring createSchedule. */
+    updateSchedule(scheduleId: string, changes: ScheduleUpdate): Promise<ScheduleRef>;
+    /** Pause / resume / cancel a schedule. pause→`POST /:id/pause`, resume→`POST /:id/resume`,
+     *  cancel→`PATCH /:id/cancel` (all bodyless). */
+    controlSchedule(scheduleId: string, action: ScheduleAction): Promise<ScheduleRef>;
+    /** Delete a schedule permanently (`DELETE /api/schedules/:id`; the backend also tears down any live run). */
+    deleteSchedule(scheduleId: string): Promise<void>;
+    /** Neutral status of a run (`GET /api/executions/:id`, id = Mongo `_id`). Progress is derived from
+     *  the per-status step counters; a UI deep link stands in for a report URL. */
+    getRun(runId: string): Promise<RunStatus>;
+    /** Neutral status of a SUITE run (`GET /api/executions/suite/:suiteRunId/summary`). `progress`
+     *  counts TEST CASES (not steps); `children` is the per-testcase rollup. A 404 right after reserve
+     *  (child execution docs not materialized yet) reads as 'queued', not an error. No reportUrl: the
+     *  `/reports/:id` deep link is keyed by a single execution's Mongo id, not a suite-run `SR_` id. */
+    private getSuiteRun;
+    /** Signal a running execution to stop. Suite runs (`SR_...`) stop via the suite endpoint
+     *  (`POST /api/executions/suite/:id/stop`); single executions via `POST /api/executions/:id/stop`.
+     *  No body either way. */
+    stopRun(runId: string): Promise<void>;
+    /** Cloud runner VMs registered to the project + live online status
+     *  (`GET /api/compute-configs/runners?live=1`). `online` already folds status online|busy. */
+    listCloudRunners(): Promise<CloudRunner[]>;
+    /**
+     * LOCAL agents registered to the project + live online status
+     * (`GET /api/agent-credentials/project-agents`) — the same live roster resolveLocalAgentCredential
+     * reads, exposed so a client can list + pick an agent (`id` = credential_id) before a LOCAL run.
+     * A shared project lists EVERY member's agent; `owner`/`online` let the user pick the right one.
+     */
+    listLocalAgents(): Promise<LocalAgent[]>;
+    /**
+     * Valid action vocabulary per technology. android/api/database/mainframe always
+     * come from the static `WALNUT_ACTIONS` (there is no live/per-org source for
+     * them); `web` is replaced by the live per-org `GET /api/actions` catalog when
+     * that call succeeds and returns at least one action, else falls back to the
+     * static list. No retry, no caching.
+     */
+    actionsCatalog(platform?: string): Promise<ActionDef[]>;
+    /** The internal hop to the local agent's /mcp, built lazily and ONLY when cfg.url is set. */
+    private hop;
+    /** The local agent's advertised tools (web/mainframe/…), mirrored so the recording passthrough can
+     *  register them. No agent configured (cloud editor) → `[]`, so no recording tools get registered
+     *  and recording is gracefully unavailable. */
+    listAgentTools(): Promise<Array<{
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }>>;
+    /** Forward an agent-bound tool call (recording) to the local agent's /mcp. Without a configured
+     *  agent /mcp (cloud editor) there is nothing to forward to, so this fails with a clear instruction. */
+    callRaw(name: string, args: Record<string, unknown>): Promise<unknown>;
+    readJournal(tcId: string): Promise<JournalView>;
+    editJournal(tcId: string, ops: JournalOp[]): Promise<JournalView>;
+    /** Deep link into the product UI (e.g. `/test-cases/:id`, `/reports/:id`). These routes are served
+     *  by walnut-frontend, NOT the API host, so this must use the FRONTEND origin. */
+    productUrlFor(entity: EntityRef): string;
+    /** Frontend origin for deep links, resolved (and trailing-slash-trimmed) as:
+     *   1. `walnutUiOrigin` (env `QA_MCP_WALNUT_UI`) -- the explicit override; point it at the local
+     *      frontend dev server now, and the deployed frontend once shipped.
+     *   2. else the BACKEND base (`cfg.baseUrl` / `QA_BASE_URL`) with a trailing `/api` stripped --
+     *      correct for a single-host deploy (https://app.walnutai.ai/api -> https://app.walnutai.ai), so
+     *      production Just Works with no override. A split local dev host (backend :8080, Vite :5173)
+     *      can't be derived, so it needs (1). NOTE: derived from `baseUrl`, NOT `cfg.url` — `cfg.url` is
+     *      now the agent /mcp endpoint, not a web origin. */
+    private resolveUiOrigin;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/walnut/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/walnut/adapter.ts"],"names":[],"mappings":"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"}