@lambdacurry/arbor 0.21.13 → 0.21.15

package/dist/arbor.js

@@ -17211,6 +17211,9 @@ config(en_default());
 var EXTERNAL_DEFAULT_PAGE_SIZE = 50;
 var EXTERNAL_DEFAULT_CONTRIB_LIMIT = 50;
 var EXTERNAL_DEFAULT_THREAD_VIEW = "compact";
+var EXTERNAL_DEFAULT_ARTIFACT_VIEW = "card";
+var ARTIFACT_SOURCE_WINDOW_DEFAULT = 80;
+var ARTIFACT_SOURCE_WINDOW_MAX = 200;
 var EXTERNAL_READ_DEFAULTS_BY_OPERATION = {};
 function recordExternalReadDefaults(operation, defaults) {
   if (!operation || !defaults)
@@ -17957,6 +17960,13 @@ var MCP_OUTPUT_SCHEMAS = {
     nextCursor: exports_external.string().nullable().optional(),
     hasMore: exports_external.boolean().optional()
   }),
+  github_refresh_installation: exports_external.looseObject({
+    installationId: id,
+    accountLogin: exports_external.string(),
+    repositorySelection: exports_external.enum(["all", "selected"]),
+    repositoryCount: exports_external.number().int().min(0),
+    lastSyncedAt: timestamp
+  }),
   github_connect_repository: exports_external.looseObject({
     repositoryId: id,
     scope: exports_external.enum(["organization", "space", "topic", "thread"]),
@@ -18007,7 +18017,11 @@ var MCP_OUTPUT_SCHEMAS = {
     unchanged: exports_external.boolean().optional()
   }),
   tree: exports_external.looseObject({ spaces: exports_external.array(treeSpace) }),
-  members: exports_external.looseObject({ members: exports_external.array(orgMember), total: exports_external.number().optional() }),
+  members: exports_external.looseObject({
+    members: exports_external.array(orgMember),
+    total: exports_external.number().optional(),
+    nextCursor: exports_external.string().optional()
+  }),
   space_create: exports_external.looseObject({ spaceId: id, visibility: exports_external.string() }),
   space_update: exports_external.looseObject({
     id,
@@ -18093,7 +18107,9 @@ var MCP_OUTPUT_SCHEMAS = {
     watching: exports_external.boolean()
   }),
   watch_list: exports_external.looseObject({
-    watches: exports_external.array(jsonObject).optional()
+    watches: exports_external.array(jsonObject).optional(),
+    total: exports_external.number().int().min(0),
+    nextCursor: exports_external.string().optional()
   }),
   curation: exports_external.looseObject({
     contributionId: id.optional(),
@@ -18126,21 +18142,19 @@ var MCP_OUTPUT_SCHEMAS = {
     threadId: id.nullable().optional(),
     changed: exports_external.boolean().optional()
   }),
-  artifact_get: exports_external.looseObject({
+  artifact_get: exports_external.object({
     id,
     title: exports_external.string(),
     kind: exports_external.string(),
-    status: exports_external.string(),
-    content: jsonObject,
-    version: exports_external.number().optional(),
-    versions: exports_external.array(jsonObject).optional(),
-    appBundles: exports_external.array(jsonObject),
-    usedByApps: exports_external.array(jsonObject),
-    livePreview: artifactLivePreview.nullable(),
-    snapshot: jsonObject.nullable().optional(),
-    sourceLivePreview: jsonObject.nullable().optional(),
-    watching: exports_external.boolean(),
-    url: exports_external.string()
+    version: exports_external.number().int().nonnegative(),
+    lineCount: exports_external.number().int().nonnegative(),
+    byteLength: exports_external.number().int().nonnegative(),
+    outline: exports_external.array(exports_external.object({ title: exports_external.string(), startLine: exports_external.number().int().min(1) })),
+    source: exports_external.string().optional(),
+    startLine: exports_external.number().int().min(0).optional(),
+    endLine: exports_external.number().int().min(0).optional(),
+    nextLine: exports_external.number().int().min(1).nullable().optional(),
+    totalLines: exports_external.number().int().nonnegative().optional()
   }),
   artifact_transition: exports_external.looseObject({
     artifactId: id,
@@ -18864,6 +18878,7 @@ var MCP_TOOL_ANNOTATIONS = {
   app_archive: additive,
   charter: destructive,
   github_repositories: readOnly,
+  github_refresh_installation: openWorld,
   github_connect_repository: idempotent,
   computer_open: additive,
   computer_reprovision: destructiveIdempotent,
@@ -18930,7 +18945,7 @@ Arbor Computer is the complete software execution platform attached to Arbor's d
 
 ${ARBOR_FEEDBACK_GUIDANCE}
 
-1. ORIENT, CONFIGURE, AND AUTHORIZE. Start with get_computer(threadId) to inspect the effective inherited recipe, repository authorization, compatibility, and durable lineage. Use set_organization_computer, set_space_computer, set_topic_computer, or set_thread_computer only when the corresponding complete sparse layer must be replaced; use github_repositories then github_connect_repository to authorize repositories at the narrowest scope that should inherit them. attach_computer mints durable protocol identity without starting a runtime; computer_open attaches as needed and starts or resumes the project environment. Each returned repository entry includes verified root instruction pointers when that repo has an AGENTS.md: read surfaced repository instructions before substantial edits or verification, then check for a nearer nested AGENTS.md once the target path is known. Repo-local instructions/scripts/config beat guessed formatter, test, lint, or build commands.
+1. ORIENT, CONFIGURE, AND AUTHORIZE. Start with get_computer(threadId) to inspect the effective inherited recipe, repository authorization, compatibility, and durable lineage. Use set_organization_computer, set_space_computer, set_topic_computer, or set_thread_computer only when the corresponding complete sparse layer must be replaced; use github_repositories then github_connect_repository to authorize repositories at the narrowest scope that should inherit them. If github_repositories looks stale, github_refresh_installation reconciles the cached inventory from GitHub. attach_computer mints durable protocol identity without starting a runtime; computer_open attaches as needed and starts or resumes the project environment. Each returned repository entry includes verified root instruction pointers when that repo has an AGENTS.md: read surfaced repository instructions before substantial edits or verification, then check for a nearer nested AGENTS.md once the target path is known. Repo-local instructions/scripts/config beat guessed formatter, test, lint, or build commands.
 2. READ THE CAPABILITIES CARD, NOT THE BACKEND. computer_open and computer_status describe the live PARENT Thread Computer and return the exact computerSessionId for parent filesystem, command, checkpoint, Preview, bundle, and stop operations. computer_status does not establish isolated Run activity; use computer_run_receipt(runId) and computer_process_read for Run-owned work. Command-line utilities, including Git and package managers, run through computer_exec; check unfamiliar binaries with command -v.
 3. ONE RUN PER TASK. A write Run defaults to an isolated execution environment with its own filesystem, processes, ports, and /tmp while preserving /workspace paths; a read Run shares the parent. Pass runId to Run-aware tools. If a response is lost, recover the durable operation/process identity from computer_run_receipt and read it before retrying. Once every operation is settled, computer_run_suspend publishes the exact workspace and releases the provider during an external wait; the next Run-aware operation restores that checkpoint under the same runId automatically. Suspension refuses active processes or unsettled outcomes and never replays unknown work, so reconcile process and Git/publication evidence first. An isolated local commit or Preview is not Git publication; push coherent work and prove it with computer_repo_work_status before computer_run_finish destroys the final placement. discard=true is the explicit choice to destroy proven non-durable work.
 4. CHECKPOINT COMPLETE PARENT UNITS. computer_checkpoint advances immutable parent lineage after an intermediate complete unit; computer_stop performs the final checkpoint before teardown. An isolated Run Preview is durable review output, not adoption or a checkpoint. The internal provider-handle publication operations are not agent tools.
@@ -19012,6 +19027,15 @@ function runAdminFeedback(ex, input) {
   return Promise.reject(new Error(`unknown verb "${verb ?? ""}" — expected one of: ${ADMIN_FEEDBACK_VERB_HELP}`));
 }
 var NOTIFICATION_TRIAGE_DESCRIPTION = "List your awareness feed newest first with unseen count and derived triage class: `settled-context` = settled Thread context; `owed-by-me` = an open request pointing to `inbox`; `judgment-available` = live engagement inviting judgment; `closed-loop` = your request completed; `room-motion` = ambient activity. Notifications are FYI, not a second obligation surface: `inbox` alone contains work owed by you; this cannot mark notifications read or modify inbox obligations.";
+var ARTIFACT_GET_INPUT = {
+  artifactId: exports_external.string().describe("the Artifact, art_…"),
+  version: exports_external.number().int().min(1).optional().describe("read this old snapshot instead of the current"),
+  startLine: exports_external.number().int().min(1).optional().describe("1-indexed source window start; omit with heading for a section window"),
+  limit: exports_external.number().int().min(1).max(ARTIFACT_SOURCE_WINDOW_MAX).optional().describe(`source window size when startLine or heading is set (default ${ARTIFACT_SOURCE_WINDOW_DEFAULT}, max ${ARTIFACT_SOURCE_WINDOW_MAX}). This is not a list page size`),
+  heading: exports_external.string().min(1).optional().describe("first ##/### title that matches exactly, else the first prefix match"),
+  all: exports_external.boolean().optional().describe("explicit complete source. Cannot combine with startLine, heading, or limit; prefer a window unless you need every line")
+};
+var ARTIFACT_GET_DESCRIPTION = `Read an Artifact as a compact card (id, title, kind, version, lineCount, byteLength, ##/### outline with startLine) so a plan can be oriented without loading source; pass startLine+limit (default ${ARTIFACT_SOURCE_WINDOW_DEFAULT}, max ${ARTIFACT_SOURCE_WINDOW_MAX}) or heading (first ##/### exact or prefix) for a source window, or all=true/--all for the full source. Pass version for an older snapshot; this read cannot edit content, bind a surface, change lifecycle, or delete.`;
 var PAGINATION_INPUT = {
   limit: exports_external.number().int().min(1).optional().describe(`max items to return. MCP/CLI/API default to ${EXTERNAL_DEFAULT_PAGE_SIZE} and return nextCursor when more remain; pass all=true/--all for the complete list. In-process web omit is still a compatibility full read`),
   cursor: exports_external.string().optional().describe("opaque cursor from a prior response's nextCursor (use with --limit)"),
@@ -19038,12 +19062,23 @@ var ACTION_DEFINITIONS = [
   {
     name: "github_repositories",
     title: "List installed GitHub repositories",
-    description: "List repositories covered by this organization's verified Arbor Computer GitHub App, returning ids and metadata but never credentials. Use github_connect_repository to authorize one at an Arbor scope; listing alone grants no Computer access.",
+    description: "List repositories covered by this organization's verified Arbor Computer GitHub App (ids and metadata, never credentials); listing alone grants no Computer access. Use github_connect_repository to authorize one at an Arbor scope, or github_refresh_installation when the cached inventory looks stale.",
     inputSchema: { ...PAGINATION_INPUT },
     surfaces: ["computer-mcp", "cli"],
     toolset: "projects",
     run: forward("github.repositories")
   },
+  {
+    name: "github_refresh_installation",
+    title: "Refresh a GitHub installation inventory",
+    description: "Reconcile one claimed GitHub App installation's cached repository inventory from GitHub without connecting repositories or changing App permissions. Org owner/admin only; pass installationId from github_repositories.",
+    inputSchema: {
+      installationId: exports_external.string().describe("claimed installation id from github_repositories, ghi_…")
+    },
+    surfaces: ["computer-mcp", "cli"],
+    toolset: "projects",
+    run: forward("github.refresh_installation")
+  },
   {
     name: "github_connect_repository",
     title: "Connect a GitHub repository",
@@ -19955,11 +19990,9 @@ var ACTION_DEFINITIONS = [
   {
     name: "get_artifact",
     title: "Read an artifact",
-    description: "Read an Artifact's current source/version/history plus its current executable Live Preview surface when bound. READ BEFORE YOU EDIT — the version number you read is the baseVersion your edit must name. Surface binding is current Artifact identity metadata and remains current even when --version reads old content.",
-    inputSchema: {
-      artifactId: exports_external.string().describe("the artifact, art_…"),
-      version: exports_external.number().optional().describe("read this old snapshot instead of the current")
-    },
+    description: ARTIFACT_GET_DESCRIPTION,
+    inputSchema: ARTIFACT_GET_INPUT,
+    externalReadDefaults: { view: EXTERNAL_DEFAULT_ARTIFACT_VIEW },
     surfaces: ["cli"],
     toolset: "artifacts",
     run: forward("artifact.get")
@@ -20285,7 +20318,7 @@ var ACTION_DEFINITIONS = [
     name: "members",
     title: "List the people + agents in your org",
     description: "List everyone in your org with profile id, human/agent identity, role, charter, and capabilities needed for routing. Use it to resolve profile ids for mentions or targeted requests; it cannot modify membership.",
-    inputSchema: {},
+    inputSchema: { ...PAGINATION_INPUT },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
     run: forward("org.members")
@@ -20771,7 +20804,7 @@ var ACTION_DEFINITIONS = [
     name: "watch_list",
     title: "List your watches",
     description: "List every Thread, Artifact, and Topic you currently watch. It cannot start or stop a watch or change notifications.",
-    inputSchema: {},
+    inputSchema: { ...PAGINATION_INPUT },
     surfaces: ["mcp"],
     toolset: "loop",
     run: forward("watch.list")
@@ -20804,7 +20837,7 @@ var ACTION_DEFINITIONS = [
     name: "watches",
     title: "List what you watch",
     description: "List every thread/artifact/topic you're watching (AD-202), newest first.",
-    inputSchema: {},
+    inputSchema: { ...PAGINATION_INPUT },
     surfaces: ["cli"],
     toolset: "loop",
     run: forward("watch.list")
@@ -20864,11 +20897,9 @@ var ACTION_DEFINITIONS = [
   {
     name: "artifact_get",
     title: "Read an Artifact",
-    description: "Read an Artifact's current source, version, immutable history, AppBundle references, and current executable Live Preview surface, or pass version for an older content snapshot. Computer-file Artifacts return snapshot state from set_snapshot (null until set_snapshot, meaning the asleep face is not checkable); this read cannot edit content, bind a surface, change lifecycle, promote an attachment, or delete an Artifact.",
-    inputSchema: {
-      artifactId: exports_external.string().describe("the Artifact, art_…"),
-      version: exports_external.number().optional().describe("read this old snapshot instead of the current")
-    },
+    description: ARTIFACT_GET_DESCRIPTION,
+    inputSchema: ARTIFACT_GET_INPUT,
+    externalReadDefaults: { view: EXTERNAL_DEFAULT_ARTIFACT_VIEW },
     surfaces: ["mcp"],
     toolset: "artifacts",
     run: forward("artifact.get")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.21.13",
+  "version": "0.21.15",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "keywords": [
     "agents",