@kivimedia/kmhub 2.9.1 → 2.11.0

package/tools/military.mjs

@@ -1,244 +1,244 @@
-/**
- * Tool family: military - the USO MWR Military Scout, read from the terminal.
- *
- * Every other radar in KM Hub is a scan that goes LOOKING for work, which is why radar.mjs
- * reaches all nine of them through one pair of mission tools. This one is not that shape. The
- * military market is ENUMERABLE rather than searchable: a finite published list of Army garrisons,
- * USO centers, Navy MWR, Marine MCCS, Air Force FSS and Coast Guard desks, each on a predictable
- * URL. So the thing a person wants from the terminal is not "what did the last scan find", it is
- * "show me what is already in there", and that needs its own family rather than a sixth entry in
- * a mission list.
- *
- *   km_military_directory    -> GET /military/directory
- *   km_military_desks        -> GET /military/desks
- *   km_military_installation -> GET /military/installations/:ref
- *
- * 🚨 READ ONLY, and there are three separate reasons, all of which the descriptions say out loud:
- *
- *   1. NOTHING HERE SUBMITS, APPROVES OR SENDS. The engine worker registers the
- *      military_radar_submit job with no browser driver, so it resolves the read-only one and
- *      structurally cannot type or press anything. Approving a packet is deliberately a human act
- *      in the web app. A terminal tool that appeared to submit would be a lie told to a government
- *      office in a client's name, which is the worst outcome this feature has available.
- *   2. NOTHING HERE STARTS A SWEEP. Queueing one is admin-only under RLS in the web app, and the
- *      API runs on the service role, which bypasses RLS: a start tool would quietly hand any
- *      read/write key a power the product refuses to a non-admin member. The sweep button lives in
- *      KM Hub where the person pressing it is checked. Whether a sweep is running is readable, and
- *      it is readable through the tool that already answers that for every radar:
- *      km_list_radar_scans with kind 'military_radar_ingest'.
- *   3. Reading costs NOTHING and sends NOTHING. The directory is shared reference data with global
- *      read, already populated before anybody runs anything, so there is no first click to make
- *      and no bill for looking.
- *
- * The family contract this file follows is documented in ./README.md.
- */
-import { z } from 'zod';
-
-export const FAMILY = 'military';
-
-export const TOOLS = [
-  'km_military_directory',
-  'km_military_desks',
-  'km_military_installation',
-];
-
-// Finding and reaching buyers is outreach work, so this family joins that profile. It is not in
-// `core`: a session that only wants orientation should not carry three more schemas.
-export const PROFILES = ['outreach'];
-
-/**
- * Has this KM Hub simply never heard of the route, or did the route run and find nothing?
- *
- * 🚨 The neighbouring families treat every 404 as "not deployed here", which is safe for them
- * because none of their routes can answer 404 themselves. This family has one that can: asking for
- * an installation that is not in the directory is a real, ordinary 404. Collapsing the two would
- * answer a plain typo with "your KM Hub does not have the military directory", which is a false
- * statement about the product rather than a wrong answer about a base. So only the router's own
- * self-describing 404, which carries the whole route list, counts as a missing route.
- */
-function routeMissing(r) {
-  if (r.status === 405 || r.status === 501) return true;
-  if (r.status !== 404) return false;
-  const body = r && r.data && typeof r.data === 'object' ? r.data : null;
-  if (!body) return true;
-  if (Array.isArray(body.routes)) return true;
-  return typeof body.message === 'string' && body.message.startsWith('Unknown route');
-}
-
-const NOT_SUPPORTED =
-  'This KM Hub does not serve the military directory to the terminal yet. Nothing is broken: the workspace is fine ' +
-  'and every other tool works as normal. The directory is there in the web app at https://hub.kivimedia.co under ' +
-  'Outbound, named USO MWR Military Scout.';
-
-/**
- * The six buyer lanes, in one clause each.
- *
- * 🚨 This paragraph is here because a client on a live call asked "what is an NAF?" and nothing
- * answered him. These labels are military shorthand, and a model that repeats them without
- * expanding them is no more useful than the raw row. Every acronym any answer can print is
- * expanded at least once here.
- */
-const LANES =
-  'The six lanes and who is actually on the other end. `special_events`: the office that puts on ' +
-  'the base own concerts, festivals and family days, which is the entertainment budget itself. ' +
-  '`marketing`: the desk that advertises those events, which rarely books an act but walks your ' +
-  'name to the office that does. `sponsorship`: commercial sponsorship, where a company pays and ' +
-  'the base receives the act, so the money never comes out of the events budget. `naf_prime`: NAF ' +
-  'is non-appropriated funds, the money a base earns from its own clubs and shops rather than from ' +
-  'Congress, and a prime is a private company that already holds the contract to spend it and hires ' +
-  'acts underneath it. `uso`: a USO center is the lounge on or beside a base that troops walk into, ' +
-  'and each center programs its own floor. `afe`: Armed Forces Entertainment, the Department of ' +
-  'Defense office that sends entertainment to troops posted overseas, which publishes no route for ' +
-  'an act to contact it at all, so nobody reaches it directly.';
-
-const NO_SEND =
-  'What it will NOT do: it cannot write to a desk, fill a form, approve a packet or send anything, ' +
-  'and no other tool here can either. Approving the words and submitting them is a person job in KM ' +
-  'Hub at https://hub.kivimedia.co, on purpose, because the other end is a government office. Never ' +
-  'tell somebody a message went out.';
-
-const NO_INVENTION =
-  'Never construct an address. These offices publish shared desk mailboxes whose middle token ' +
-  'differs per garrison, so an address that is not in the answer does not exist to us, and a phone ' +
-  'or web form with no mailbox beside it is the NORMAL published state here rather than missing data.';
-
-export function register(server, call, { out, text, qs }) {
-  server.tool(
-    'km_military_directory',
-    'The military entertainment buyers KM Hub has already enumerated: every Army garrison, USO center, Navy MWR, ' +
-      'Marine MCCS, Air Force FSS and Coast Guard desk that publishes a way for an act to reach it, plus the global ' +
-      'gateways. ' +
-      'Reach for it whenever somebody asks about military work, bases, garrisons, the USO, MWR, overseas troops or ' +
-      'who books entertainment on a base, and reach for it FIRST rather than describing the feature: this directory ' +
-      'is shared reference data that is already full before anybody runs anything, so there is nothing to start and ' +
-      'nothing to wait for. Reading it costs nothing, spends nothing and sends nothing. ' +
-      '🚨 Lead with the `directory` block, which is counted from the rows and not asserted: how many installations, ' +
-      'how many distinct desks, how many are overseas, and when it was last read. Say those numbers before any ' +
-      'individual row, because the single thing people get wrong about this surface is assuming it is empty. ' +
-      'Call it with no arguments to see the whole thing, then narrow. Every filter is optional and `filters_applied` ' +
-      'says back which ones are doing the narrowing, so an empty result is explained rather than shrugged at. ' +
-      LANES +
-      ' ' +
-      NO_INVENTION +
-      ' ' +
-      'Whether a sweep is running is a different question, answered by km_list_radar_scans with kind ' +
-      "'military_radar_ingest'. Starting one is done in KM Hub, never from here. " +
-      NO_SEND,
-    {
-      q: z
-        .string()
-        .optional()
-        .describe(
-          'Free text, in the words the person used. Matches the name, the place, the region, the branch as the ' +
-            'badge words it, and the theater heading, in any order: "okinawa uso" and "uso okinawa" both work.',
-        ),
-      branch: z
-        .enum(['army', 'navy', 'usmc', 'usaf', 'uscg', 'uso', 'afe', 'naf_prime'])
-        .optional()
-        .describe('One service or gateway. Leave it out to see all of them.'),
-      lane: z
-        .enum(['special_events', 'marketing', 'sponsorship', 'afe', 'naf_prime', 'uso'])
-        .optional()
-        .describe('Only installations that publish a desk on this buyer lane. See the lane guide in this description.'),
-      route: z
-        .enum(['email', 'phone', 'form'])
-        .optional()
-        .describe('Only installations reachable this way. Use it when somebody says they want places they can email.'),
-      region: z
-        .string()
-        .optional()
-        .describe('A region or theater as published or as grouped, for example "Europe", "Indo Pacific", "Japan", "Germany".'),
-      state: z.string().optional().describe('A US state or province. Most rows publish no state, so prefer region or q.'),
-      overseas: z
-        .boolean()
-        .optional()
-        .describe('True for installations outside the continental United States only, including Guam and Puerto Rico.'),
-      limit: z.number().int().min(1).max(200).optional().describe('How many installations to return. Default 40. Check `truncated`.'),
-    },
-    async ({ q, branch, lane, route, region, state, overseas, limit }) => {
-      const r = await call('GET', `/military/directory${qs({ q, branch, lane, route, region, state, overseas, limit })}`);
-      if (routeMissing(r)) return text(NOT_SUPPORTED, true);
-      return out(r);
-    },
-  );
-
-  server.tool(
-    'km_military_desks',
-    'The desks themselves rather than the places: one row per mailbox, phone line or web form, however many ' +
-      'installations it serves. ' +
-      'This is the list to reach for when somebody asks who they would actually contact, or wants the special events ' +
-      'offices in Europe, or the mailboxes they could write to. ' +
-      '🚨 `serves_installations` is the number that matters and is the whole reason this tool exists separately from ' +
-      'km_military_directory: one regional USO organisation answers a SINGLE mailbox for every center under it, so a ' +
-      'list counted by location would have somebody send the same desk the same message eight times, which is the ' +
-      'fastest way to be ignored across an entire branch. One desk, one message. ' +
-      'Most of these buyers publish no named person, so `contact_name` is usually empty and that is the office ' +
-      'working normally, not a gap to fill in. `source_url` is the page each route was read off, and `evidence_quote` ' +
-      'is available on the installation view if somebody wants to see the wording it came from. ' +
-      NO_INVENTION +
-      ' ' +
-      'Read only. Costs nothing, spends nothing. ' +
-      NO_SEND,
-    {
-      lane: z
-        .enum(['special_events', 'marketing', 'sponsorship', 'afe', 'naf_prime', 'uso'])
-        .optional()
-        .describe('The buyer lane. Different lanes spend different budgets and each needs its own message.'),
-      route: z
-        .enum(['email', 'phone', 'form'])
-        .optional()
-        .describe('Only desks reachable this way. "email" is the one to use when somebody wants a list they can write to.'),
-      branch: z
-        .enum(['army', 'navy', 'usmc', 'usaf', 'uscg', 'uso', 'afe', 'naf_prime'])
-        .optional()
-        .describe('One service or gateway.'),
-      region: z.string().optional().describe('A region or theater, for example "Europe", "Indo Pacific", "Germany".'),
-      q: z.string().optional().describe('Free text against the installation the desk belongs to, in the words the person used.'),
-      overseas: z.boolean().optional().describe('True for desks outside the continental United States only.'),
-      limit: z.number().int().min(1).max(200).optional().describe('How many desks to return. Default 40, busiest desks first. Check `truncated`.'),
-    },
-    async ({ lane, route, branch, region, q, overseas, limit }) => {
-      const r = await call('GET', `/military/desks${qs({ lane, route, branch, region, q, overseas, limit })}`);
-      if (routeMissing(r)) return text(NOT_SUPPORTED, true);
-      return out(r);
-    },
-  );
-
-  server.tool(
-    'km_military_installation',
-    'One installation in full: every desk it publishes with its lane and its route, the page each one was read off, ' +
-      'the events on its own calendar, and whatever outreach this workspace has already recorded against it. ' +
-      'Use it after km_military_directory when somebody picks a base, or whenever they name one directly. It takes ' +
-      'either the id from a previous answer or the slug, for example "benning". ' +
-      'The events are the why-now: naming a garrison own event is the difference between a note that gets read and ' +
-      'one that gets filed. ' +
-      '🚨 `window_is_published` decides whether the pitch window may be spoken as a fact. True means the date came off ' +
-      'something the installation actually published. False means it was worked out from the usual season and this ' +
-      'year date is not out yet, so it is a guess and must never be repeated as though it were confirmed. ' +
-      '`your_outreach` is this workspace own audit trail and nothing more. A packet reading `approved` means a named ' +
-      'person signed off those exact words and NOTHING has been sent to the desk. `possibly_submitted` means a submit ' +
-      'button was pressed and the page could not be read back afterwards, so that garrison may or may not hold the ' +
-      'packet: only somebody who telephones the office can settle it, and it is never retried on its own. ' +
-      NO_INVENTION +
-      ' ' +
-      'Read only. Costs nothing, spends nothing. ' +
-      NO_SEND,
-    {
-      installation: z
-        .string()
-        .describe('The installation id from a previous answer, or its slug, for example "benning" or "uso-okinawa".'),
-    },
-    async ({ installation }) => {
-      const ref = String(installation || '').trim();
-      if (!ref) {
-        return text(
-          'I need to know which installation. km_military_directory lists them, and each row carries the id and the ' +
-            'slug this tool takes.',
-        );
-      }
-      const r = await call('GET', `/military/installations/${encodeURIComponent(ref)}`);
-      if (routeMissing(r)) return text(NOT_SUPPORTED, true);
-      return out(r);
-    },
-  );
-}
+/**
+ * Tool family: military - the USO MWR Military Scout, read from the terminal.
+ *
+ * Every other radar in KM Hub is a scan that goes LOOKING for work, which is why radar.mjs
+ * reaches all nine of them through one pair of mission tools. This one is not that shape. The
+ * military market is ENUMERABLE rather than searchable: a finite published list of Army garrisons,
+ * USO centers, Navy MWR, Marine MCCS, Air Force FSS and Coast Guard desks, each on a predictable
+ * URL. So the thing a person wants from the terminal is not "what did the last scan find", it is
+ * "show me what is already in there", and that needs its own family rather than a sixth entry in
+ * a mission list.
+ *
+ *   km_military_directory    -> GET /military/directory
+ *   km_military_desks        -> GET /military/desks
+ *   km_military_installation -> GET /military/installations/:ref
+ *
+ * 🚨 READ ONLY, and there are three separate reasons, all of which the descriptions say out loud:
+ *
+ *   1. NOTHING HERE SUBMITS, APPROVES OR SENDS. The engine worker registers the
+ *      military_radar_submit job with no browser driver, so it resolves the read-only one and
+ *      structurally cannot type or press anything. Approving a packet is deliberately a human act
+ *      in the web app. A terminal tool that appeared to submit would be a lie told to a government
+ *      office in a client's name, which is the worst outcome this feature has available.
+ *   2. NOTHING HERE STARTS A SWEEP. Queueing one is admin-only under RLS in the web app, and the
+ *      API runs on the service role, which bypasses RLS: a start tool would quietly hand any
+ *      read/write key a power the product refuses to a non-admin member. The sweep button lives in
+ *      KM Hub where the person pressing it is checked. Whether a sweep is running is readable, and
+ *      it is readable through the tool that already answers that for every radar:
+ *      km_list_radar_scans with kind 'military_radar_ingest'.
+ *   3. Reading costs NOTHING and sends NOTHING. The directory is shared reference data with global
+ *      read, already populated before anybody runs anything, so there is no first click to make
+ *      and no bill for looking.
+ *
+ * The family contract this file follows is documented in ./README.md.
+ */
+import { z } from 'zod';
+
+export const FAMILY = 'military';
+
+export const TOOLS = [
+  'km_military_directory',
+  'km_military_desks',
+  'km_military_installation',
+];
+
+// Finding and reaching buyers is outreach work, so this family joins that profile. It is not in
+// `core`: a session that only wants orientation should not carry three more schemas.
+export const PROFILES = ['outreach'];
+
+/**
+ * Has this KM Hub simply never heard of the route, or did the route run and find nothing?
+ *
+ * 🚨 The neighbouring families treat every 404 as "not deployed here", which is safe for them
+ * because none of their routes can answer 404 themselves. This family has one that can: asking for
+ * an installation that is not in the directory is a real, ordinary 404. Collapsing the two would
+ * answer a plain typo with "your KM Hub does not have the military directory", which is a false
+ * statement about the product rather than a wrong answer about a base. So only the router's own
+ * self-describing 404, which carries the whole route list, counts as a missing route.
+ */
+function routeMissing(r) {
+  if (r.status === 405 || r.status === 501) return true;
+  if (r.status !== 404) return false;
+  const body = r && r.data && typeof r.data === 'object' ? r.data : null;
+  if (!body) return true;
+  if (Array.isArray(body.routes)) return true;
+  return typeof body.message === 'string' && body.message.startsWith('Unknown route');
+}
+
+const NOT_SUPPORTED =
+  'This KM Hub does not serve the military directory to the terminal yet. Nothing is broken: the workspace is fine ' +
+  'and every other tool works as normal. The directory is there in the web app at https://hub.kivimedia.co under ' +
+  'Outbound, named USO MWR Military Scout.';
+
+/**
+ * The six buyer lanes, in one clause each.
+ *
+ * 🚨 This paragraph is here because a client on a live call asked "what is an NAF?" and nothing
+ * answered him. These labels are military shorthand, and a model that repeats them without
+ * expanding them is no more useful than the raw row. Every acronym any answer can print is
+ * expanded at least once here.
+ */
+const LANES =
+  'The six lanes and who is actually on the other end. `special_events`: the office that puts on ' +
+  'the base own concerts, festivals and family days, which is the entertainment budget itself. ' +
+  '`marketing`: the desk that advertises those events, which rarely books an act but walks your ' +
+  'name to the office that does. `sponsorship`: commercial sponsorship, where a company pays and ' +
+  'the base receives the act, so the money never comes out of the events budget. `naf_prime`: NAF ' +
+  'is non-appropriated funds, the money a base earns from its own clubs and shops rather than from ' +
+  'Congress, and a prime is a private company that already holds the contract to spend it and hires ' +
+  'acts underneath it. `uso`: a USO center is the lounge on or beside a base that troops walk into, ' +
+  'and each center programs its own floor. `afe`: Armed Forces Entertainment, the Department of ' +
+  'Defense office that sends entertainment to troops posted overseas, which publishes no route for ' +
+  'an act to contact it at all, so nobody reaches it directly.';
+
+const NO_SEND =
+  'What it will NOT do: it cannot write to a desk, fill a form, approve a packet or send anything, ' +
+  'and no other tool here can either. Approving the words and submitting them is a person job in KM ' +
+  'Hub at https://hub.kivimedia.co, on purpose, because the other end is a government office. Never ' +
+  'tell somebody a message went out.';
+
+const NO_INVENTION =
+  'Never construct an address. These offices publish shared desk mailboxes whose middle token ' +
+  'differs per garrison, so an address that is not in the answer does not exist to us, and a phone ' +
+  'or web form with no mailbox beside it is the NORMAL published state here rather than missing data.';
+
+export function register(server, call, { out, text, qs }) {
+  server.tool(
+    'km_military_directory',
+    'The military entertainment buyers KM Hub has already enumerated: every Army garrison, USO center, Navy MWR, ' +
+      'Marine MCCS, Air Force FSS and Coast Guard desk that publishes a way for an act to reach it, plus the global ' +
+      'gateways. ' +
+      'Reach for it whenever somebody asks about military work, bases, garrisons, the USO, MWR, overseas troops or ' +
+      'who books entertainment on a base, and reach for it FIRST rather than describing the feature: this directory ' +
+      'is shared reference data that is already full before anybody runs anything, so there is nothing to start and ' +
+      'nothing to wait for. Reading it costs nothing, spends nothing and sends nothing. ' +
+      '🚨 Lead with the `directory` block, which is counted from the rows and not asserted: how many installations, ' +
+      'how many distinct desks, how many are overseas, and when it was last read. Say those numbers before any ' +
+      'individual row, because the single thing people get wrong about this surface is assuming it is empty. ' +
+      'Call it with no arguments to see the whole thing, then narrow. Every filter is optional and `filters_applied` ' +
+      'says back which ones are doing the narrowing, so an empty result is explained rather than shrugged at. ' +
+      LANES +
+      ' ' +
+      NO_INVENTION +
+      ' ' +
+      'Whether a sweep is running is a different question, answered by km_list_radar_scans with kind ' +
+      "'military_radar_ingest'. Starting one is done in KM Hub, never from here. " +
+      NO_SEND,
+    {
+      q: z
+        .string()
+        .optional()
+        .describe(
+          'Free text, in the words the person used. Matches the name, the place, the region, the branch as the ' +
+            'badge words it, and the theater heading, in any order: "okinawa uso" and "uso okinawa" both work.',
+        ),
+      branch: z
+        .enum(['army', 'navy', 'usmc', 'usaf', 'uscg', 'uso', 'afe', 'naf_prime'])
+        .optional()
+        .describe('One service or gateway. Leave it out to see all of them.'),
+      lane: z
+        .enum(['special_events', 'marketing', 'sponsorship', 'afe', 'naf_prime', 'uso'])
+        .optional()
+        .describe('Only installations that publish a desk on this buyer lane. See the lane guide in this description.'),
+      route: z
+        .enum(['email', 'phone', 'form'])
+        .optional()
+        .describe('Only installations reachable this way. Use it when somebody says they want places they can email.'),
+      region: z
+        .string()
+        .optional()
+        .describe('A region or theater as published or as grouped, for example "Europe", "Indo Pacific", "Japan", "Germany".'),
+      state: z.string().optional().describe('A US state or province. Most rows publish no state, so prefer region or q.'),
+      overseas: z
+        .boolean()
+        .optional()
+        .describe('True for installations outside the continental United States only, including Guam and Puerto Rico.'),
+      limit: z.number().int().min(1).max(200).optional().describe('How many installations to return. Default 40. Check `truncated`.'),
+    },
+    async ({ q, branch, lane, route, region, state, overseas, limit }) => {
+      const r = await call('GET', `/military/directory${qs({ q, branch, lane, route, region, state, overseas, limit })}`);
+      if (routeMissing(r)) return text(NOT_SUPPORTED, true);
+      return out(r);
+    },
+  );
+
+  server.tool(
+    'km_military_desks',
+    'The desks themselves rather than the places: one row per mailbox, phone line or web form, however many ' +
+      'installations it serves. ' +
+      'This is the list to reach for when somebody asks who they would actually contact, or wants the special events ' +
+      'offices in Europe, or the mailboxes they could write to. ' +
+      '🚨 `serves_installations` is the number that matters and is the whole reason this tool exists separately from ' +
+      'km_military_directory: one regional USO organisation answers a SINGLE mailbox for every center under it, so a ' +
+      'list counted by location would have somebody send the same desk the same message eight times, which is the ' +
+      'fastest way to be ignored across an entire branch. One desk, one message. ' +
+      'Most of these buyers publish no named person, so `contact_name` is usually empty and that is the office ' +
+      'working normally, not a gap to fill in. `source_url` is the page each route was read off, and `evidence_quote` ' +
+      'is available on the installation view if somebody wants to see the wording it came from. ' +
+      NO_INVENTION +
+      ' ' +
+      'Read only. Costs nothing, spends nothing. ' +
+      NO_SEND,
+    {
+      lane: z
+        .enum(['special_events', 'marketing', 'sponsorship', 'afe', 'naf_prime', 'uso'])
+        .optional()
+        .describe('The buyer lane. Different lanes spend different budgets and each needs its own message.'),
+      route: z
+        .enum(['email', 'phone', 'form'])
+        .optional()
+        .describe('Only desks reachable this way. "email" is the one to use when somebody wants a list they can write to.'),
+      branch: z
+        .enum(['army', 'navy', 'usmc', 'usaf', 'uscg', 'uso', 'afe', 'naf_prime'])
+        .optional()
+        .describe('One service or gateway.'),
+      region: z.string().optional().describe('A region or theater, for example "Europe", "Indo Pacific", "Germany".'),
+      q: z.string().optional().describe('Free text against the installation the desk belongs to, in the words the person used.'),
+      overseas: z.boolean().optional().describe('True for desks outside the continental United States only.'),
+      limit: z.number().int().min(1).max(200).optional().describe('How many desks to return. Default 40, busiest desks first. Check `truncated`.'),
+    },
+    async ({ lane, route, branch, region, q, overseas, limit }) => {
+      const r = await call('GET', `/military/desks${qs({ lane, route, branch, region, q, overseas, limit })}`);
+      if (routeMissing(r)) return text(NOT_SUPPORTED, true);
+      return out(r);
+    },
+  );
+
+  server.tool(
+    'km_military_installation',
+    'One installation in full: every desk it publishes with its lane and its route, the page each one was read off, ' +
+      'the events on its own calendar, and whatever outreach this workspace has already recorded against it. ' +
+      'Use it after km_military_directory when somebody picks a base, or whenever they name one directly. It takes ' +
+      'either the id from a previous answer or the slug, for example "benning". ' +
+      'The events are the why-now: naming a garrison own event is the difference between a note that gets read and ' +
+      'one that gets filed. ' +
+      '🚨 `window_is_published` decides whether the pitch window may be spoken as a fact. True means the date came off ' +
+      'something the installation actually published. False means it was worked out from the usual season and this ' +
+      'year date is not out yet, so it is a guess and must never be repeated as though it were confirmed. ' +
+      '`your_outreach` is this workspace own audit trail and nothing more. A packet reading `approved` means a named ' +
+      'person signed off those exact words and NOTHING has been sent to the desk. `possibly_submitted` means a submit ' +
+      'button was pressed and the page could not be read back afterwards, so that garrison may or may not hold the ' +
+      'packet: only somebody who telephones the office can settle it, and it is never retried on its own. ' +
+      NO_INVENTION +
+      ' ' +
+      'Read only. Costs nothing, spends nothing. ' +
+      NO_SEND,
+    {
+      installation: z
+        .string()
+        .describe('The installation id from a previous answer, or its slug, for example "benning" or "uso-okinawa".'),
+    },
+    async ({ installation }) => {
+      const ref = String(installation || '').trim();
+      if (!ref) {
+        return text(
+          'I need to know which installation. km_military_directory lists them, and each row carries the id and the ' +
+            'slug this tool takes.',
+        );
+      }
+      const r = await call('GET', `/military/installations/${encodeURIComponent(ref)}`);
+      if (routeMissing(r)) return text(NOT_SUPPORTED, true);
+      return out(r);
+    },
+  );
+}