@miadi/connector 0.1.21 → 0.1.23

package/dist/tools.js

@@ -37,6 +37,18 @@ import { canReadReading, readingOwner } from "./reading/privacy.js";
 import { artefactVisibility, readArtefactWeave, saveResearchArtefact } from "@miadi/inquiry-weave";
 import { ResearchUploads, UploadRefusal } from "./uploads.js";
 import { DEFAULT_PAGE_BYTES, FOUNDATIONS_PERMISSION, FileRefusal, MAX_TEXT_BYTES, MIN_PAGE_BYTES, TEXT_TYPES, checkRelativePath, episodeNumberOf, extensionOf, fileRef, holdsFoundationRead, isFoundationDoc, pageOf, parseFileRef, } from "./episode-files.js";
+/** Which standard judges a mission now, and whether Jev takes part; no key value is read into it. */
+async function standardStatus(service) {
+    const standard = await service.standard();
+    return {
+        name: standard.name,
+        version: standard.version,
+        source: standard.source,
+        ...(standard.note ? { note: standard.note } : {}),
+        aspects: standard.aspects.map((a) => ({ code: a.code, name: a.name, requires: a.requires, settled_by: a.settled_by })),
+        jev: service.jevConfigured ? "configured" : "unconfigured",
+    };
+}
 class ToolRefusal extends Error {
     code;
     detail;
@@ -101,6 +113,8 @@ const primaryIssue = z
     .regex(/^[\w.-]+\/[\w.-]+#\d+$/)
     .optional()
     .describe("owner/repo#n: the one issue this mission implements. Other refs stay related. Without it, mission_status can only infer the mission from the first issue in refs (jgwill/Miadi#913).");
+const deliveryField = z.string().min(1).max(500).optional().describe("The one exact place the result lands: a path, a branch, a pull request, an issue, a review or an episode. Not a kind of place or a choice among places (jgwill/Miadi#939).");
+const personWordsField = z.string().min(1).max(4000).optional().describe("The person's own words, verbatim from your conversation, for any rule, correction or decision the mission credits to them. The person reads them on the card and the worker reads them in the brief.");
 /** Refs with the declared primary issue first, never duplicated. */
 function withPrimary(refs, primary) {
     return primary ? [primary, ...refs.filter((r) => r !== primary)] : refs;
@@ -255,6 +269,10 @@ export function registerTools(server, ctx) {
             ...fields,
         });
     };
+    /** A person's standing preferences are read by that person and by the write tier. */
+    const reviewShownTo = (review, r, reader) => review ? (reader.api_tier === "write" || r.actor.person_id === reader.id ? review : { ...review, preferences: [] }) : null;
+    /** The report for a mission's current version; a failure here never refuses the request (jgwill/Miadi#939). */
+    const draftReviewOf = async (r) => ctx.draftReview ? ctx.draftReview.review(all().find((x) => x.id === r.id) ?? r, all()) : { state: "unavailable", message: "This connector runs no draft review." };
     /**
      * A forwarded steer's record moves when the runtime's evidence moves: done once the model has it,
      * stopped once it never will. The ledger then agrees with its delivery on every surface that reads it
@@ -371,6 +389,7 @@ export function registerTools(server, ctx) {
                 ledger: "connector ledger (append-only, /srv/miadi/connector)",
             },
             tools: TOOL_STATUS,
+            mission_standard: ctx.draftReview ? await standardStatus(ctx.draftReview) : { state: "unavailable" },
             // Registered is not operational: whether a steer can reach a pane on this host now (jgwill/Miadi#909).
             steering: { ...steeringTransport(ctx.tmux), runtime_route: ctx.steeringRuntime ? "configured" : "not_configured", contract: STEERING_CONTRACT },
             foundation_read: {
@@ -828,6 +847,7 @@ export function registerTools(server, ctx) {
             ...(r.kind === "session_steer_request" && ctx.steeringRuntime && person.api_tier === "write" ? { delivery: readSteerDelivery(ctx.steeringRuntime, all().find((x) => x.id === r.id) ?? r) ?? undefined } : {}),
             // Where the request stands, in the words every surface uses (jgwill/Miadi#889).
             projection: requestProjection(r, { reviewBase: ctx.approval?.config.reviewUrl, factoryDir: ctx.factoryDir }),
+            ...(r.kind === "run_request" || r.kind === "work_proposal" ? { draft_review: reviewShownTo(ctx.draftReview?.stored(r), r, person) } : {}),
             ...(r.approval_state === "revision_requested"
                 ? { revision: { instructions: r.completion_receipt?.instructions, next: `Revise it in place: revise_pending_request with request_id ${r.id} and expected_version ${versionOf(r)}.` } }
                 : {}),
@@ -1291,6 +1311,8 @@ export function registerTools(server, ctx) {
             refs,
             primary_issue: primaryIssue,
             repo: z.string().max(120).optional(),
+            delivery: deliveryField,
+            person_words: personWordsField,
             ...base,
         },
         annotations: WRITE,
@@ -1305,9 +1327,16 @@ export function registerTools(server, ctx) {
             idempotency_key: a.idempotency_key,
             state: "pending",
             approval_state: "awaiting_approval",
-            body: { title: a.title, desired_outcome: a.desired_outcome, repo: a.repo, ...(a.primary_issue ? { primary_issue: a.primary_issue } : {}) },
+            body: {
+                title: a.title,
+                desired_outcome: a.desired_outcome,
+                repo: a.repo,
+                ...(a.primary_issue ? { primary_issue: a.primary_issue } : {}),
+                ...(a.delivery ? { delivery: a.delivery } : {}),
+                ...(a.person_words ? { person_words: a.person_words } : {}),
+            },
         });
-        return { ...r, approval_url: approvalUrl(r.id) };
+        return { ...r, approval_url: approvalUrl(r.id), draft_review: await draftReviewOf(r) };
     }));
     server.registerTool("prepare_calendar_event", {
         title: "Draft a calendar event",
@@ -1474,10 +1503,12 @@ export function registerTools(server, ctx) {
         title: "Request a bounded agent run",
         description: "Ask for an agent session to do one bounded task. The request waits for a person with Miadi's write tier to approve it on the returned approval_url; once approved, a brief is queued for the factory intake, which opens or reaches the session within minutes. Read it back with get_run_result. This is for a new mission only: to change a request that still awaits a decision, call revise_pending_request with its id, so the person keeps one card to decide.",
         inputSchema: {
-            task: z.string().min(1).max(12000).describe("What the session does and what it returns."),
+            task: z.string().min(1).max(12000).describe("What the session does and what it returns. State the result that will exist rather than the mechanism, unless the person asked for the mechanism."),
             circle,
             refs,
             primary_issue: primaryIssue,
+            delivery: deliveryField,
+            person_words: personWordsField,
             session: z.string().regex(/^[A-Za-z0-9._-]{3,80}$/).optional().describe("An existing tmux session to hand it to, or a name for a new one."),
             cwd: z.string().max(300).optional().describe("Working folder for a new session (default: the factory runner's defaultCwd on the host)."),
             provider: z
@@ -1520,12 +1551,15 @@ export function registerTools(server, ctx) {
                 provider: a.provider,
                 resolved_provider: resolution.provider.id,
                 ...(a.primary_issue ? { primary_issue: a.primary_issue } : {}),
+                ...(a.delivery ? { delivery: a.delivery } : {}),
+                ...(a.person_words ? { person_words: a.person_words } : {}),
                 ...(a.steering ? { steering: a.steering } : {}),
             },
         });
         const authorization = providerAuthorizationOf(all().find((x) => x.id === r.id) ?? r);
         return {
             ...r,
+            draft_review: await draftReviewOf(r),
             provider: {
                 requested: a.provider ?? null,
                 resolved: resolution.provider.id,
@@ -1571,6 +1605,8 @@ export function registerTools(server, ctx) {
                 circle: circle.optional(),
                 refs: z.array(z.string()).max(50).optional().describe("The whole new list of refs, replacing the old one."),
                 primary_issue: primaryIssue,
+                delivery: deliveryField,
+                person_words: personWordsField,
                 session: z.string().regex(/^[A-Za-z0-9._-]{3,80}$/).optional(),
                 cwd: z.string().max(300).optional(),
                 provider: z.enum(["codex", "pi", "copilot", "claude"]).optional().describe("Verified installed on the connector host again, as request_authorized_run does."),
@@ -1619,6 +1655,9 @@ export function registerTools(server, ctx) {
         }
         if (c.primary_issue !== undefined)
             body.primary_issue = c.primary_issue;
+        for (const k of ["delivery", "person_words"])
+            if (c[k] !== undefined)
+                body[k] = c[k];
         const nextRefs = withPrimary(c.refs ?? live?.refs ?? [], c.primary_issue ?? body.primary_issue);
         let record;
         try {
@@ -1643,6 +1682,7 @@ export function registerTools(server, ctx) {
         const revisedAuthorization = providerAuthorizationOf(all().find((x) => x.id === (record.supersedes ?? record.id)));
         return {
             ...revisionOut(record.supersedes ? { ...record, id: record.supersedes } : record),
+            draft_review: await draftReviewOf(all().find((x) => x.id === (record.supersedes ?? record.id)) ?? record),
             revised: record.revision,
             ...(provider ? { provider } : {}),
             ...(revisedAuthorization ? { provider_authorization: authorizationOut(revisedAuthorization) } : {}),
@@ -2252,6 +2292,13 @@ export function registerTools(server, ctx) {
                 intention: r.intention,
                 consequence: consequenceOf(r, providerAuthorizationOf(r)),
                 detail: detailOf(r),
+                ...(r.kind === "run_request" || r.kind === "work_proposal"
+                    ? {
+                        delivery: r.body.delivery,
+                        person_words: r.body.person_words,
+                        draft_review: ctx.draftReview?.stored(r) ?? null,
+                    }
+                    : {}),
                 ...(r.kind === "run_request" ? { provider_authorization: authorizationOut(providerAuthorizationOf(r)) } : {}),
                 approval_url: approvalUrl(r.id),
                 projection: requestProjection(r, { reviewBase: ctx.approval?.config.reviewUrl, factoryDir: ctx.factoryDir }),
@@ -2457,11 +2504,11 @@ export const TOOL_STATUS = {
     register_source_intent: "live, contribute",
     record_handoff: "live, contribute",
     update_handoff: "live, contribute",
-    propose_work: "live, contribute, needs_approval (approving starts the work as a factory run)",
+    propose_work: "live, contribute, needs_approval (approving starts the work as a factory run; answers with draft_review)",
     prepare_calendar_event: "live, contribute (draft and .ics only)",
     propose_session_completion: "live, contribute, needs_approval (decision recorded, nothing closed)",
-    request_authorized_run: "live, contribute, needs_approval (queues a factory brief once approved; may name a verified provider and a bounded steering grant)",
-    revise_pending_request: "live, contribute (a waiting or sent-back run or proposal gets its next version; same id, same card)",
+    request_authorized_run: "live, contribute, needs_approval (queues a factory brief once approved; may name a verified provider and a bounded steering grant; answers with draft_review)",
+    revise_pending_request: "live, contribute (a waiting or sent-back run or proposal gets its next version; same id, same card; answers with draft_review)",
     get_request_history: "live (every version of a request, oldest first; whoever asked, or the write tier)",
     supersede_pending_requests: "live, contribute (retires named earlier requests still waiting and joins them as earlier versions of the one that stands)",
     request_session_steer: "live, contribute, write tier (one correction to a working agent, forwarded to its runtime; runs inside an approved run's steering grant, else one scoped human decision; get_capabilities.steering says whether the transport works now and which providers have an adapter)",

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.1.21";
+export declare const VERSION = "0.1.23";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.1.21";
+export const VERSION = "0.1.23";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/connector",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "The Miadi connector: one remote MCP service through which a person signed in with their Miadi person token, from ChatGPT or any MCP client, reads sessions, reviews, episodes and circles and records observations, inquiries, handoffs and proposals with their name on each record.",
   "license": "MIT",
   "author": "Miadi",
@@ -38,7 +38,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@miadi/inquiry-weave": "0.18.8",
+    "@miadi/inquiry-weave": "0.18.10",
     "@miadi/node-service-kit": "0.1.2",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "express": "^5.2.1",