manychat-ai-agent 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.19.0](https://github.com/pedronastasi/manychat-ai-agent/compare/v0.18.1...v0.19.0) (2026-10-07)
+
+
+### Features
+
+* learn selling tactics from paid outcomes, behind human approval (spec 031) ([9a35ce0](https://github.com/pedronastasi/manychat-ai-agent/commit/9a35ce0ad221974595d1dec59cd78a33b2d07bfd))
+
+
+### Bug Fixes
+
+* record no playbook version on a fallback reply, and let a stop end a learning run ([1dadf7d](https://github.com/pedronastasi/manychat-ai-agent/commit/1dadf7d235da2ce4f6e7c1b6e741306fc67fcf8e))
+* say that a stopped learning run forfeits its week, and warn when one does ([af1935e](https://github.com/pedronastasi/manychat-ai-agent/commit/af1935ec35031d3a34dd8f50ba459473d56cacba))
+* say why a learning run failed, in the server's log and in the terminal of a CLI run ([0ea3783](https://github.com/pedronastasi/manychat-ai-agent/commit/0ea37839266ff87b309eeb04c75ed2f1983b163f))
+
+
+### Specs and Docs
+
+* a guide to learning from outcomes: how it works, setting it up, and the weekly routine ([5c9d42f](https://github.com/pedronastasi/manychat-ai-agent/commit/5c9d42fd68944d5818cec54dc43d75cb42245616))
+* record PR 187 in spec 031 ([79f17c0](https://github.com/pedronastasi/manychat-ai-agent/commit/79f17c042d26ca7bb32934d00e95db4704a8c86f))
+
+## [0.18.1](https://github.com/pedronastasi/manychat-ai-agent/compare/v0.18.0...v0.18.1) (2026-10-07)
+
+
+### Specs and Docs
+
+* add a getting-started guide for npm create, and point to it from the top of the README ([893e8da](https://github.com/pedronastasi/manychat-ai-agent/commit/893e8dac5a668d6e20ae2439822894a4c3aaa71d))
+* derive a top bar, collapse the long sidebar groups, and fix badge and heading styling on the site ([2faca35](https://github.com/pedronastasi/manychat-ai-agent/commit/2faca35920a98ecbe7e8d3e4ec1e5a45372068b5))
+* derive nav bar from sections, collapse long groups, add getting-started guide ([31a3fde](https://github.com/pedronastasi/manychat-ai-agent/commit/31a3fde37dcee03b7847f21523114335623bc036))
+
 ## [0.18.0](https://github.com/pedronastasi/manychat-ai-agent/compare/v0.17.1...v0.18.0) (2026-10-06)
 
 

package/README.md

@@ -29,6 +29,17 @@ and an embedded [PGlite](https://pglite.dev/) Postgres. In another terminal,
 
 ![pnpm simulate answering a price question from the catalog and escalating a request for a person](docs/assets/demo.svg)
 
+That clone is for trying the agent and working on it. To run one for your own
+business, generate a project of your own instead, which depends on the published
+package rather than a copy of this repository:
+
+```bash
+npm create manychat-ai-agent@latest my-agent
+```
+
+[Starting a new agent](docs/guides/getting-started.md) walks through it,
+from the offline first run to a deployment.
+
 ---
 
 ## The problem this solves
@@ -366,7 +377,8 @@ It writes `config/`, an offline `.env`, an eval suite, CI, Compose and
 Renovate, depending on the agent and its image at the scaffolder's version.
 Replace `config/` with your own and keep the repository private: the generated
 CI fails when it is public
-([specs/035](specs/035-create-scaffolds-a-tenant-project.md)).
+([specs/035](specs/035-create-scaffolds-a-tenant-project.md)). The steps are in
+[Starting a new agent](docs/guides/getting-started.md).
 
 Point a ManyChat **Dynamic Block** (Dev Tools, requires a Pro plan) at
 `POST /v1/channels/manychat/message` and add an `Authorization: Bearer <secret>`

package/db/migrations/0010_oval_prism.sql

@@ -0,0 +1,54 @@
+CREATE TABLE "eval_records" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenant_id" text NOT NULL,
+	"playbook_hash" text NOT NULL,
+	"suite_hash" text NOT NULL,
+	"model" text NOT NULL,
+	"outcomes" jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "insight_proposals" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenant_id" text NOT NULL,
+	"run_id" uuid NOT NULL,
+	"text" text NOT NULL,
+	"rationale" text NOT NULL,
+	"enrolled_count" integer NOT NULL,
+	"not_enrolled_count" integer NOT NULL,
+	"turn_ids" jsonb NOT NULL,
+	"status" text DEFAULT 'pending' NOT NULL,
+	"reviewed_at" timestamp with time zone,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "learning_runs" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenant_id" text NOT NULL,
+	"week" text NOT NULL,
+	"forced" boolean DEFAULT false NOT NULL,
+	"status" text DEFAULT 'running' NOT NULL,
+	"enrolled_count" integer,
+	"not_enrolled_count" integer,
+	"cost_usd" numeric(12, 6),
+	"started_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"finished_at" timestamp with time zone
+);
+--> statement-breakpoint
+CREATE TABLE "playbook_versions" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenant_id" text NOT NULL,
+	"content_hash" text NOT NULL,
+	"insights" jsonb NOT NULL,
+	"active" boolean DEFAULT false NOT NULL,
+	"activated_at" timestamp with time zone,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "turns" ADD COLUMN "playbook_version" text;--> statement-breakpoint
+ALTER TABLE "insight_proposals" ADD CONSTRAINT "insight_proposals_run_id_learning_runs_id_fk" FOREIGN KEY ("run_id") REFERENCES "public"."learning_runs"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX "eval_records_lookup_idx" ON "eval_records" USING btree ("tenant_id","playbook_hash","suite_hash");--> statement-breakpoint
+CREATE INDEX "insight_proposals_tenant_status_idx" ON "insight_proposals" USING btree ("tenant_id","status");--> statement-breakpoint
+CREATE UNIQUE INDEX "learning_runs_week_uq" ON "learning_runs" USING btree ("tenant_id","week") WHERE "learning_runs"."forced" = false;--> statement-breakpoint
+CREATE UNIQUE INDEX "playbook_versions_content_uq" ON "playbook_versions" USING btree ("tenant_id","content_hash");--> statement-breakpoint
+CREATE UNIQUE INDEX "playbook_versions_one_active_uq" ON "playbook_versions" USING btree ("tenant_id") WHERE "playbook_versions"."active" = true;