{"id":"@lssm-tech/example.messaging-agent-actions","slug":"example.messaging-agent-actions","name":"@lssm-tech/example.messaging-agent-actions","version":"5.0.4","path":"examples/messaging-agent-actions","manifestPath":"examples/messaging-agent-actions/package.json","manifestBlobSha":"0faebb6a1067415eeab0620ae1b54696981bb575","layer":"examples","physicalArea":null,"primaryArea":"examples-and-patterns","classification":{"privateDeclared":null,"catalogFamily":"solutions","catalogKind":"example","catalogStatus":"active","adoptionMode":"reference-only","stability":"stable"},"description":"Safe messaging agent actions example with fixed intents, allowlisted actions, workflow dispatch, and deterministic replies.","descriptionOrigin":"package.json","catalog":{"family":"solutions","kind":"example","status":"active","adoptionMode":"reference-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./contracts","./contracts/process-message.operation","./docs","./docs/messaging-agent-actions.docblock","./example","./handlers","./handlers/messaging-agent-actions.handlers","./messaging-agent-actions.feature","./proof/meetup-proof"],"documentation":[{"title":"Example Messaging Agent Actions documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.messaging-agent-actions","kind":"readme"}],"examples":[],"replacements":[],"nonAdoptableRationale":"This example is published for reference and learning, not as a reusable library dependency."},"canonicalImports":[],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","dev":"contractspec-bun-build dev","clean":"rimraf dist .turbo","lint":"bun lint:fix","lint:fix":"node ../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../scripts/biome.cjs check --write .","lint:check":"node ../../scripts/biome.cjs check .","test":"bun test","proof":"bun ../../scripts/generate-messaging-agent-actions-meetup-proof.ts","preflight":"bun run build && bun run typecheck && bun run test && bun run proof","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-spec":"workspace:^","@lssm-tech/lib.schema":"workspace:^","@lssm-tech/module.communication-os":"workspace:^"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./contracts":"./src/contracts/index.ts","./contracts/process-message.operation":"./src/contracts/process-message.operation.ts","./docs":"./src/docs/index.ts","./docs/messaging-agent-actions.docblock":"./src/docs/index.ts","./example":"./src/example.ts","./handlers":"./src/handlers/index.ts","./handlers/messaging-agent-actions.handlers":"./src/handlers/messaging-agent-actions.handlers.ts","./messaging-agent-actions.feature":"./src/messaging-agent-actions.feature.ts","./proof/meetup-proof":"./src/proof/meetup-proof.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./contracts":{"types":"./dist/contracts/index.d.ts","browser":"./dist/browser/contracts/index.js","bun":"./dist/contracts/index.js","node":"./dist/node/contracts/index.js","default":"./dist/contracts/index.js"},"./contracts/process-message.operation":{"types":"./dist/contracts/process-message.operation.d.ts","browser":"./dist/browser/contracts/process-message.operation.js","bun":"./dist/contracts/process-message.operation.js","node":"./dist/node/contracts/process-message.operation.js","default":"./dist/contracts/process-message.operation.js"},"./docs":{"types":"./dist/docs/index.d.ts","browser":"./dist/browser/docs/index.js","bun":"./dist/docs/index.js","node":"./dist/node/docs/index.js","default":"./dist/docs/index.js"},"./docs/messaging-agent-actions.docblock":{"types":"./dist/docs/index.d.ts","browser":"./dist/browser/docs/index.js","bun":"./dist/docs/index.js","node":"./dist/node/docs/index.js","default":"./dist/docs/index.js"},"./example":{"types":"./dist/example.d.ts","browser":"./dist/browser/example.js","bun":"./dist/example.js","node":"./dist/node/example.js","default":"./dist/example.js"},"./handlers":{"types":"./dist/handlers/index.d.ts","browser":"./dist/browser/handlers/index.js","bun":"./dist/handlers/index.js","node":"./dist/node/handlers/index.js","default":"./dist/handlers/index.js"},"./handlers/messaging-agent-actions.handlers":{"types":"./dist/handlers/messaging-agent-actions.handlers.d.ts","browser":"./dist/browser/handlers/messaging-agent-actions.handlers.js","bun":"./dist/handlers/messaging-agent-actions.handlers.js","node":"./dist/node/handlers/messaging-agent-actions.handlers.js","default":"./dist/handlers/messaging-agent-actions.handlers.js"},"./messaging-agent-actions.feature":{"types":"./dist/messaging-agent-actions.feature.d.ts","browser":"./dist/browser/messaging-agent-actions.feature.js","bun":"./dist/messaging-agent-actions.feature.js","node":"./dist/node/messaging-agent-actions.feature.js","default":"./dist/messaging-agent-actions.feature.js"},"./proof/meetup-proof":{"types":"./dist/proof/meetup-proof.d.ts","browser":"./dist/browser/proof/meetup-proof.js","bun":"./dist/proof/meetup-proof.js","node":"./dist/node/proof/meetup-proof.js","default":"./dist/proof/meetup-proof.js"}},"types":"./dist/index.d.ts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/example.messaging-agent-actions","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"examples/messaging-agent-actions/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./contracts","importPath":"@lssm-tech/example.messaging-agent-actions/contracts","target":"./src/contracts/index.ts","targets":[{"conditions":[],"target":"./src/contracts/index.ts","sourcePath":"examples/messaging-agent-actions/src/contracts/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/contracts/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./contracts/process-message.operation","importPath":"@lssm-tech/example.messaging-agent-actions/contracts/process-message.operation","target":"./src/contracts/process-message.operation.ts","targets":[{"conditions":[],"target":"./src/contracts/process-message.operation.ts","sourcePath":"examples/messaging-agent-actions/src/contracts/process-message.operation.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/contracts/process-message.operation.ts","sourceStatus":"verified source file"}]},{"subpath":"./docs","importPath":"@lssm-tech/example.messaging-agent-actions/docs","target":"./src/docs/index.ts","targets":[{"conditions":[],"target":"./src/docs/index.ts","sourcePath":"examples/messaging-agent-actions/src/docs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/docs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./docs/messaging-agent-actions.docblock","importPath":"@lssm-tech/example.messaging-agent-actions/docs/messaging-agent-actions.docblock","target":"./src/docs/index.ts","targets":[{"conditions":[],"target":"./src/docs/index.ts","sourcePath":"examples/messaging-agent-actions/src/docs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/docs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./example","importPath":"@lssm-tech/example.messaging-agent-actions/example","target":"./src/example.ts","targets":[{"conditions":[],"target":"./src/example.ts","sourcePath":"examples/messaging-agent-actions/src/example.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/example.ts","sourceStatus":"verified source file"}]},{"subpath":"./handlers","importPath":"@lssm-tech/example.messaging-agent-actions/handlers","target":"./src/handlers/index.ts","targets":[{"conditions":[],"target":"./src/handlers/index.ts","sourcePath":"examples/messaging-agent-actions/src/handlers/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/handlers/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./handlers/messaging-agent-actions.handlers","importPath":"@lssm-tech/example.messaging-agent-actions/handlers/messaging-agent-actions.handlers","target":"./src/handlers/messaging-agent-actions.handlers.ts","targets":[{"conditions":[],"target":"./src/handlers/messaging-agent-actions.handlers.ts","sourcePath":"examples/messaging-agent-actions/src/handlers/messaging-agent-actions.handlers.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/handlers/messaging-agent-actions.handlers.ts","sourceStatus":"verified source file"}]},{"subpath":"./messaging-agent-actions.feature","importPath":"@lssm-tech/example.messaging-agent-actions/messaging-agent-actions.feature","target":"./src/messaging-agent-actions.feature.ts","targets":[{"conditions":[],"target":"./src/messaging-agent-actions.feature.ts","sourcePath":"examples/messaging-agent-actions/src/messaging-agent-actions.feature.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/messaging-agent-actions.feature.ts","sourceStatus":"verified source file"}]},{"subpath":"./proof/meetup-proof","importPath":"@lssm-tech/example.messaging-agent-actions/proof/meetup-proof","target":"./src/proof/meetup-proof.ts","targets":[{"conditions":[],"target":"./src/proof/meetup-proof.ts","sourcePath":"examples/messaging-agent-actions/src/proof/meetup-proof.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/src/proof/meetup-proof.ts","sourceStatus":"verified source file"}]}],"entryCount":10,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Example Messaging Agent Actions documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.messaging-agent-actions","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.messaging-agent-actions.txt"},"readme":{"status":"available","body":"# @lssm-tech/example.messaging-agent-actions\n\nSafe messaging agent actions example with fixed intents, allowlisted action execution, workflow dispatch, and deterministic confirmation replies.\n\n## What This Demonstrates\n\n- Inbound message normalization for Slack, WhatsApp, Telegram, or any messaging bridge.\n- Fixed intent parsing: `status`, `run action`, and `dispatch workflow`.\n- Allowlisted action and workflow routing instead of arbitrary tool execution.\n- Replayable meetup proof for the canonical status -> action -> workflow walkthrough.\n\n## Running Locally\n\nFrom `examples/messaging-agent-actions`:\n- `bun run build`\n- `bun run test`\n- `bun run typecheck`\n- `bun run proof`\n- `bun run preflight`\n\n## Usage\n\nUse this package when you need a conservative messaging demo that proves agent actions can stay safe, typed, and reviewable even when messages come from live provider webhooks.\n\n## Public Entry Points\n\n- Export `.` resolves through `./src/index.ts`.\n- Export `./contracts` resolves through `./src/contracts/index.ts`.\n- Export `./docs` resolves through `./src/docs/index.ts`.\n- Export `./example` resolves through `./src/example.ts`.\n- Export `./handlers` resolves through `./src/handlers/index.ts`.\n- Export `./messaging-agent-actions.feature` resolves through `./src/messaging-agent-actions.feature.ts`.\n- Export `./proof/*` resolves through `./src/proof/*.ts`.\n\n## Local Commands\n\n- `bun run build` — contractspec-bun-build build\n- `bun run test` — bun test\n- `bun run typecheck` — tsgo --noEmit\n- `bun run proof` — bun ../../scripts/generate-messaging-agent-actions-meetup-proof.ts\n- `bun run preflight` — bun run build && bun run typecheck && bun run test && bun run proof\n","sourcePath":"examples/messaging-agent-actions/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/messaging-agent-actions/README.md","blobSha":"74a356db11c0349d964ffc2676fb18a9fa51fbff","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"examples-and-patterns","areaTitle":"Examples and implementation patterns","displayName":"example.messaging-agent-actions","runtimes":["node"],"platforms":["server"],"kind":"example","scope":"Package manifest","canonicalRoute":"/docs/packages/example.messaging-agent-actions/","contextUrl":"/docs/packages/example.messaging-agent-actions.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}