bamboo-agents 0.1.5-dev.64.96d1b4d → 0.1.5-dev.66.797bc1f

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # bamboo-agents
2
2
 
3
+ > ⛔️ **FROZEN / deprioritized (runtime pivot, 2026-06).** This CLI is **not under active development** and **no new releases are being cut.** In the current model the workspace clone is server-side (connect your GitHub org), so the CLI is off the critical path. The package is intentionally left in place (not deleted) — revive it if the local-agent path returns. See `docs/architecture/runtime-pivot-teardown-playbook.md` (BAM-3274).
4
+
3
5
  CLI for setting up your local [Bamboo](https://withbamboo.com) workspace.
4
6
 
5
7
  ```bash
package/dist/VERSION CHANGED
@@ -1 +1 @@
1
- 0.1.5-dev.64.96d1b4d
1
+ 0.1.5-dev.66.797bc1f
package/dist/index.js CHANGED
@@ -3037,7 +3037,7 @@ var VERSION;
3037
3037
  var init_version = __esm({
3038
3038
  "src/version.ts"() {
3039
3039
  "use strict";
3040
- VERSION = "0.1.5-dev.64.96d1b4d";
3040
+ VERSION = "0.1.5-dev.66.797bc1f";
3041
3041
  }
3042
3042
  });
3043
3043
 
@@ -12646,11 +12646,112 @@ var init_install_token = __esm({
12646
12646
  }
12647
12647
  });
12648
12648
 
12649
- // ../../src/lib/api-contracts/cli/episodes.ts
12650
- var CliOutcomeEpisodeRequestSchema, CliOutcomeEpisodeResponseSchema;
12649
+ // ../../src/lib/api-contracts/episodes/index.ts
12650
+ var KnowledgeCiteSchema, EpisodeCiteSchema, NoPriorHistoryCiteSchema, CiteSchema, CitesArraySchema, DecompositionPartSchema, DecompositionSchema, InsightBodySchema, RecommendationBodySchema, ActionBodySchema, OutcomeBodySchema, FeedbackBodySchema, EpisodeBaseFields, EpisodeInsertSchema, EpisodeRowSchema;
12651
12651
  var init_episodes = __esm({
12652
+ "../../src/lib/api-contracts/episodes/index.ts"() {
12653
+ init_zod();
12654
+ KnowledgeCiteSchema = external_exports.object({
12655
+ /** Repo-relative path, e.g. `brands/acme/knowledge/competitors.md`. */
12656
+ path: external_exports.string().min(1).max(512),
12657
+ /** Verbatim excerpt from the file (validated at write time against blob). */
12658
+ excerpt: external_exports.string().min(1).max(2e3),
12659
+ /** Git SHA of the commit where this excerpt was read. */
12660
+ sha: external_exports.string().min(7).max(64)
12661
+ });
12662
+ EpisodeCiteSchema = external_exports.object({
12663
+ /** Back-reference to a prior episode (e.g. outcome cites recommendation). */
12664
+ episode_id: external_exports.string().uuid()
12665
+ });
12666
+ NoPriorHistoryCiteSchema = external_exports.object({
12667
+ kind: external_exports.literal("no-prior-history")
12668
+ });
12669
+ CiteSchema = external_exports.union([KnowledgeCiteSchema, EpisodeCiteSchema, NoPriorHistoryCiteSchema]);
12670
+ CitesArraySchema = external_exports.array(CiteSchema);
12671
+ DecompositionPartSchema = external_exports.object({
12672
+ /** What this part is, e.g. "Google Ads" or "Week of Jun 2". */
12673
+ label: external_exports.string().max(200).optional(),
12674
+ /** The numeric value of this part. Finite (no NaN/Infinity) for safe arithmetic. */
12675
+ value: external_exports.number().finite()
12676
+ });
12677
+ DecompositionSchema = external_exports.object({
12678
+ /** What is being decomposed, e.g. "Spend by channel". */
12679
+ label: external_exports.string().max(200).optional(),
12680
+ /** The parts the total is split into (at least one). */
12681
+ parts: external_exports.array(DecompositionPartSchema).min(1),
12682
+ /** The stated total the parts should sum to. */
12683
+ total: external_exports.number().finite()
12684
+ });
12685
+ InsightBodySchema = external_exports.object({
12686
+ /** Short summary of the insight. */
12687
+ summary: external_exports.string().min(1).max(4e3),
12688
+ findings: external_exports.array(external_exports.record(external_exports.unknown())).optional()
12689
+ });
12690
+ RecommendationBodySchema = external_exports.object({
12691
+ /** Short imperative title, e.g. "Increase Budget on Brand Campaigns". */
12692
+ title: external_exports.string().min(1).max(500),
12693
+ /** Explanation grounded in evidence. */
12694
+ rationale: external_exports.string().min(1).max(8e3),
12695
+ action_items: external_exports.array(external_exports.string().max(1e3)).optional(),
12696
+ /**
12697
+ * Optional structured breakdown of a total into parts. When present, it is
12698
+ * checked deterministically by `arithmetic-reconcile.ts` (BAM-2995) — the
12699
+ * precise, model-free complement to the LLM `decomposition_reconciles` check.
12700
+ */
12701
+ decomposition: DecompositionSchema.optional()
12702
+ });
12703
+ ActionBodySchema = external_exports.object({
12704
+ /** Human-readable description of the action taken. */
12705
+ description: external_exports.string().min(1).max(4e3),
12706
+ tool_calls: external_exports.array(external_exports.record(external_exports.unknown())).optional()
12707
+ });
12708
+ OutcomeBodySchema = external_exports.object({
12709
+ /** What happened after the action was taken. */
12710
+ description: external_exports.string().min(1).max(4e3),
12711
+ metrics_before: external_exports.record(external_exports.unknown()).optional(),
12712
+ metrics_after: external_exports.record(external_exports.unknown()).optional()
12713
+ });
12714
+ FeedbackBodySchema = external_exports.object({
12715
+ /** true = approved, false = declined. */
12716
+ approved: external_exports.boolean(),
12717
+ /** Free-form reason, especially on decline. */
12718
+ reason: external_exports.string().max(2e3).optional(),
12719
+ /** Links this feedback episode to the conversation where the user responded. */
12720
+ conversation_id: external_exports.string().uuid().optional()
12721
+ });
12722
+ EpisodeBaseFields = external_exports.object({
12723
+ org_id: external_exports.string().uuid(),
12724
+ brand_id: external_exports.string().uuid(),
12725
+ agent_id: external_exports.string().uuid().optional(),
12726
+ conversation_id: external_exports.string().uuid().optional(),
12727
+ trace_id: external_exports.string().max(256).optional(),
12728
+ parent_episode_id: external_exports.string().uuid().optional(),
12729
+ cites: CitesArraySchema.optional().default([]),
12730
+ idempotency_key: external_exports.string().min(1).max(256).optional()
12731
+ });
12732
+ EpisodeInsertSchema = external_exports.discriminatedUnion("type", [
12733
+ EpisodeBaseFields.extend({ type: external_exports.literal("insight"), body: InsightBodySchema }),
12734
+ EpisodeBaseFields.extend({ type: external_exports.literal("recommendation"), body: RecommendationBodySchema }),
12735
+ EpisodeBaseFields.extend({ type: external_exports.literal("action"), body: ActionBodySchema }),
12736
+ EpisodeBaseFields.extend({ type: external_exports.literal("outcome"), body: OutcomeBodySchema }),
12737
+ EpisodeBaseFields.extend({ type: external_exports.literal("feedback"), body: FeedbackBodySchema })
12738
+ ]);
12739
+ EpisodeRowSchema = EpisodeBaseFields.extend({
12740
+ id: external_exports.string().uuid(),
12741
+ type: external_exports.enum(["insight", "recommendation", "action", "outcome", "feedback"]),
12742
+ body: external_exports.record(external_exports.unknown()),
12743
+ cites: CitesArraySchema,
12744
+ created_at: external_exports.string().datetime()
12745
+ });
12746
+ }
12747
+ });
12748
+
12749
+ // ../../src/lib/api-contracts/cli/episodes.ts
12750
+ var CliOutcomeEpisodeRequestSchema, CliOutcomeEpisodeResponseSchema, CliRecEpisodeRequestSchema, CliRecEpisodeResponseSchema;
12751
+ var init_episodes2 = __esm({
12652
12752
  "../../src/lib/api-contracts/cli/episodes.ts"() {
12653
12753
  init_zod();
12754
+ init_episodes();
12654
12755
  CliOutcomeEpisodeRequestSchema = external_exports.object({
12655
12756
  brand_id: external_exports.string().uuid(),
12656
12757
  /** The recommendation episode this outcome follows. */
@@ -12665,6 +12766,19 @@ var init_episodes = __esm({
12665
12766
  parent_episode_id: external_exports.string().uuid(),
12666
12767
  created_at: external_exports.string()
12667
12768
  });
12769
+ CliRecEpisodeRequestSchema = external_exports.object({
12770
+ brand_id: external_exports.string().uuid(),
12771
+ title: external_exports.string().min(1).max(500),
12772
+ rationale: external_exports.string().min(1).max(8e3),
12773
+ action_items: external_exports.array(external_exports.string().max(1e3)).optional(),
12774
+ cites: CitesArraySchema,
12775
+ conversation_id: external_exports.string().uuid().optional(),
12776
+ idempotency_key: external_exports.string().min(1).max(256).optional()
12777
+ });
12778
+ CliRecEpisodeResponseSchema = external_exports.object({
12779
+ episode_id: external_exports.string().uuid(),
12780
+ is_no_prior_history: external_exports.boolean()
12781
+ });
12668
12782
  }
12669
12783
  });
12670
12784
 
@@ -13159,6 +13273,19 @@ async function postOutcomeEpisode(bambooSession, body) {
13159
13273
  const json = await res.json();
13160
13274
  return CliOutcomeEpisodeResponseSchema.parse(json);
13161
13275
  }
13276
+ async function postRecEpisode(bambooSession, body) {
13277
+ const res = await cliApiFetch(`${apiBase()}/api/v1/cli/episodes/recommendation`, {
13278
+ method: "POST",
13279
+ headers: {
13280
+ Authorization: `Bearer ${bambooSession}`,
13281
+ "Content-Type": "application/json"
13282
+ },
13283
+ body: JSON.stringify(body)
13284
+ });
13285
+ if (!res.ok) throw await parseError(res);
13286
+ const json = await res.json();
13287
+ return CliRecEpisodeResponseSchema.parse(json);
13288
+ }
13162
13289
  var PROD_DEFAULT_BASE, DEV_DEFAULT_BASE, REQUEST_TIMEOUT_MS, ApiError, OAuthRelinkStartResponseSchema, ProvisionWorkspaceResponseSchema, FirstAutoInstalledAgentResponseSchema, SkillCatalogEntrySchema, SkillCatalogResponseSchema, SkillSubscriptionsResponseSchema, ScaffoldSkillResponseSchema;
13163
13290
  var init_api = __esm({
13164
13291
  "src/lib/api.ts"() {
@@ -13182,7 +13309,7 @@ var init_api = __esm({
13182
13309
  init_onboarding_status();
13183
13310
  init_context_health();
13184
13311
  init_install_token();
13185
- init_episodes();
13312
+ init_episodes2();
13186
13313
  init_version();
13187
13314
  PROD_DEFAULT_BASE = "https://withbamboo.com";
13188
13315
  DEV_DEFAULT_BASE = "https://dev.withbamboo.com";
@@ -18680,7 +18807,8 @@ var init_agents2 = __esm({
18680
18807
  // src/commands/episode.ts
18681
18808
  var episode_exports = {};
18682
18809
  __export(episode_exports, {
18683
- runEpisodeLogOutcome: () => runEpisodeLogOutcome
18810
+ runEpisodeLogOutcome: () => runEpisodeLogOutcome,
18811
+ runEpisodeLogRec: () => runEpisodeLogRec
18684
18812
  });
18685
18813
  async function requireSession10() {
18686
18814
  const creds = await readCredentials();
@@ -18742,6 +18870,76 @@ async function runEpisodeLogOutcome(options) {
18742
18870
  console.log("");
18743
18871
  }
18744
18872
  }
18873
+ async function runEpisodeLogRec(options) {
18874
+ if (!options.brand || !options.title || !options.rationale) {
18875
+ console.error(
18876
+ "bamboo-agents: `episode log-rec` requires --brand, --title, and --rationale."
18877
+ );
18878
+ process.exit(2);
18879
+ }
18880
+ if (!options.cites && !options.noPriorHistory) {
18881
+ console.error(
18882
+ "bamboo-agents: `episode log-rec` requires either --cites '<json>' or --no-prior-history."
18883
+ );
18884
+ process.exit(2);
18885
+ }
18886
+ let cites = [];
18887
+ if (options.noPriorHistory) {
18888
+ cites = [{ kind: "no-prior-history" }];
18889
+ } else if (options.cites) {
18890
+ try {
18891
+ cites = JSON.parse(options.cites);
18892
+ if (!Array.isArray(cites)) throw new Error("cites must be a JSON array");
18893
+ } catch (e) {
18894
+ console.error(
18895
+ `bamboo-agents: --cites must be a valid JSON array, e.g. '[{"path":"...","excerpt":"...","sha":"..."}]': ${e.message}`
18896
+ );
18897
+ process.exit(2);
18898
+ }
18899
+ }
18900
+ let actionItems;
18901
+ if (options.actionItems) {
18902
+ try {
18903
+ actionItems = JSON.parse(options.actionItems);
18904
+ if (!Array.isArray(actionItems)) throw new Error("action-items must be a JSON array");
18905
+ } catch (e) {
18906
+ console.error(
18907
+ `bamboo-agents: --action-items must be a valid JSON array of strings: ${e.message}`
18908
+ );
18909
+ process.exit(2);
18910
+ }
18911
+ }
18912
+ const session = await requireSession10();
18913
+ let result;
18914
+ try {
18915
+ result = await postRecEpisode(session, {
18916
+ brand_id: options.brand,
18917
+ title: options.title,
18918
+ rationale: options.rationale,
18919
+ ...actionItems ? { action_items: actionItems } : {},
18920
+ cites,
18921
+ ...options.conversationId ? { conversation_id: options.conversationId } : {},
18922
+ ...options.idempotencyKey ? { idempotency_key: options.idempotencyKey } : {}
18923
+ });
18924
+ } catch (err) {
18925
+ if (options.json) {
18926
+ console.log(JSON.stringify({ ok: false, error: err.message }));
18927
+ } else {
18928
+ console.error(`bamboo-agents: recommendation entry failed: ${err.message}`);
18929
+ }
18930
+ process.exit(1);
18931
+ }
18932
+ if (options.json) {
18933
+ console.log(JSON.stringify({ ok: true, ...result }));
18934
+ return;
18935
+ }
18936
+ if (!options.quiet) {
18937
+ const kind = result.is_no_prior_history ? " (no prior history \u2014 cold start)" : "";
18938
+ console.log("");
18939
+ console.log(` \u2713 Recommendation logged${kind} \u2014 episode ${result.episode_id}`);
18940
+ console.log("");
18941
+ }
18942
+ }
18745
18943
  var init_episode = __esm({
18746
18944
  "src/commands/episode.ts"() {
18747
18945
  "use strict";
@@ -19164,6 +19362,18 @@ episode.command("log-outcome").description(
19164
19362
  const { runEpisodeLogOutcome: runEpisodeLogOutcome2 } = await Promise.resolve().then(() => (init_episode(), episode_exports));
19165
19363
  await runEpisodeLogOutcome2(options);
19166
19364
  });
19365
+ episode.command("log-rec").description(
19366
+ "Log a cited recommendation episode (sandbox-Boo pilot runtime, BAM-2944)"
19367
+ ).requiredOption("--brand <id>", "Brand id the recommendation belongs to").requiredOption("--title <text>", "Short imperative title for the recommendation").requiredOption("--rationale <text>", "Explanation grounded in evidence").option(
19368
+ "--cites <json>",
19369
+ "JSON array of citations \u2014 [{path, excerpt, sha}] or [{episode_id}]. Omit when --no-prior-history is set."
19370
+ ).option(
19371
+ "--no-prior-history",
19372
+ "Brand has no prior knowledge to cite (cold-start). Mutually exclusive with --cites."
19373
+ ).option("--action-items <json>", "Optional JSON array of action item strings").option("--conversation-id <uuid>", "Conversation UUID to link this episode to a Boo session").option("--idempotency-key <key>", "Client key \u2014 same key + same brand returns existing episode").option("--json", "Emit a JSON envelope for agent consumption").option("--quiet", "Suppress human chatter (data/errors only)").action(async (options) => {
19374
+ const { runEpisodeLogRec: runEpisodeLogRec2 } = await Promise.resolve().then(() => (init_episode(), episode_exports));
19375
+ await runEpisodeLogRec2(options);
19376
+ });
19167
19377
  (async () => {
19168
19378
  const rawArgs = process.argv.slice(2);
19169
19379
  const { operands } = program2.parseOptions(rawArgs);