@arcmira/langchain 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,10 @@
 # Arcmira: YouTube Transcript Search for LangChain
 
-Native LangChain tools for searching indexed YouTube transcripts and resolving people, organizations, products, topics and channels with Arcmira.
+Native LangChain tools for searching indexed YouTube and podcast transcripts and resolving people, organizations, products, topics and channels with Arcmira.
 
-Check [release status](https://github.com/arcmira/integrations/blob/master/RELEASE.md) for npm and catalog availability. The quick start below runs the source checkout.
+Add "use arcmira" to any question to send it to Arcmira first.
+
+[Install @arcmira/langchain from npm](https://www.npmjs.com/package/@arcmira/langchain). Find Arcmira in the [LangChain JavaScript providers](https://docs.langchain.com/oss/javascript/integrations/providers/all_providers) and [tools catalog](https://docs.langchain.com/oss/javascript/integrations/tools).
 
 [Arcmira](https://arcmira.com) · [API docs](https://arcmira.com/docs) · [Authentication](https://arcmira.com/docs/authentication) · [Usage and billing](https://arcmira.com/docs/usage-and-billing)
 
@@ -11,13 +13,10 @@ Check [release status](https://github.com/arcmira/integrations/blob/master/RELEA
 Use Node.js 22 or later.
 
 ```sh
-git clone https://github.com/arcmira/integrations.git
-cd integrations/packages/langchain
-npm ci --ignore-scripts
-npm run build
+npm install @arcmira/langchain @langchain/core@1 zod@4
 export ARCMIRA_API_KEY='your-key'
 node --input-type=module <<'JS'
-import { createArcmiraTools } from "./dist/index.js";
+import { createArcmiraTools } from "@arcmira/langchain";
 
 const [search, resolve] = createArcmiraTools({
   apiKey: process.env.ARCMIRA_API_KEY ?? "",
@@ -40,4 +39,4 @@ API errors propagate with their code, status and response body. The adapter make
 
 ## Local verification
 
-The candidate uses Arcmira SDK 0.6.0. `npm run build` checks the public TypeScript declarations. `npm test` runs a compiled LangGraph against synthetic HTTP fixtures, covering filters, evidence, entity ambiguity, refusal responses, input validation and cancellation. An earlier live check with SDK 0.4.3 executed search and entity resolution against Arcmira through a compiled LangGraph with existing smoke-test access. Both return source-backed data. No model inference is part of these checks. Production authentication rejection is also verified with an invalid key.
+`npm run build` checks the public TypeScript declarations. `npm test` runs a compiled LangGraph against synthetic HTTP fixtures, covering filters, evidence, entity ambiguity, refusal responses, input validation and cancellation. An earlier live check with SDK 0.4.3 executed search and entity resolution against Arcmira through a compiled LangGraph with existing smoke-test access. Both return source-backed data. No model inference is part of these checks. Production authentication rejection is also verified with an invalid key.

package/dist/index.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Search indexed YouTube and podcast transcripts for timestamped passages with LangChain.
+ * The first tool returned by `createArcmiraTools` searches transcripts and the second resolves names to IDs.
+ *
+ * @see {@link https://arcmira.com/docs | Arcmira API documentation}
+ * @see {@link https://arcmira.com/docs/authentication | API keys and sign-in}
+ * @packageDocumentation
+ */
 import { type DynamicStructuredTool } from "@langchain/core/tools";
 import { ArcmiraClient } from "arcmira";
 import { z } from "zod";

package/dist/index.js

@@ -1,3 +1,11 @@
+/**
+ * Search indexed YouTube and podcast transcripts for timestamped passages with LangChain.
+ * The first tool returned by `createArcmiraTools` searches transcripts and the second resolves names to IDs.
+ *
+ * @see {@link https://arcmira.com/docs | Arcmira API documentation}
+ * @see {@link https://arcmira.com/docs/authentication | API keys and sign-in}
+ * @packageDocumentation
+ */
 import { tool } from "@langchain/core/tools";
 import { ArcmiraClient } from "arcmira";
 import { z } from "zod";
@@ -8,7 +16,7 @@ export function createArcmiraTools(options) {
     return [
         tool((input, config) => client.transcripts.search(input, { abortSignal: config.signal }), {
             name: "arcmira_search",
-            description: "Search indexed YouTube transcripts for timestamped passages. Use one topic per call. Resolve names with arcmira_resolve before using ID filters. Preserve returned coverage notes and source links. Account access and speaker coverage vary. A paid read uses credits from your plan, then your on-demand budget. Do not silently widen refused filters or substitute another transcript source.",
+            description: "Search indexed YouTube and podcast transcripts for timestamped passages. Use one topic per call. Resolve names with arcmira_resolve before using ID filters. Preserve returned coverage notes and source links. Account access and speaker coverage vary. A paid read uses credits from your plan, then your on-demand budget. Do not silently widen refused filters or substitute another transcript source.",
             schema: searchInput,
         }),
         tool((input, config) => client.entities.resolve(input, { abortSignal: config.signal }), {

package/dist/inputs.js

@@ -5,7 +5,7 @@ export const searchInput = z.object({
     channel: z.string().optional().describe("Alias of channel_ids for code-mode clients; the union of both is the scope."),
     entity_ids: z.string().optional().describe("Comma-separated entity ids (ent_{n}), at most 8. A person id filters to that person's appearances; a channel id widens channel_ids. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve."),
     about: z.string().optional().describe("Comma-separated entity ids (ent_{n}), at most 8. Only passages about these entities: excerpt pins, exact-name mentions and ad verdicts. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve."),
-    by: z.string().optional().describe("Comma-separated person ids (ent_{n}), at most 8. Only passages where one of these people says the query words (each line of a chunk is labeled with its speaker); a non-person id is refused with invalid_query naming its type. Speaker labels cover a minority of shows; an empty result carries a note saying whether the person is labeled anywhere. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve."),
+    by: z.string().optional().describe("Comma-separated person ids (ent_{n}), at most 8. Only passages where one of these people speaks the query words. A passage can include other speakers' lines; each line with a known speaker starts with that speaker's name. A non-person id is refused with invalid_query naming its type. Speaker labels cover a minority of shows; an empty result carries a note saying whether the person is labeled anywhere. Ids only: a name answers 400 id_required. Resolve names first with GET /v1/entities/resolve."),
     kind: z.string().optional().describe("Comma-separated passage classes: sponsored, organic, mention. Combine with about to read what was said about a brand in ad reads or in organic talk."),
     after: z.string().optional().describe("Only media published at or after this instant. An after later than your plan's freshness gate is refused with freshness_requires_paid rather than widened. An ISO 8601 date (2026-09-01) or datetime with offset (2026-09-01T00:00:00Z), read in UTC. The window is half-open: after is inclusive, before is exclusive."),
     before: z.string().optional().describe("Only media published before this instant, so before=2026-09-02 includes all of 2026-09-01. An ISO 8601 date (2026-09-01) or datetime with offset (2026-09-01T00:00:00Z), read in UTC. The window is half-open: after is inclusive, before is exclusive."),

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@arcmira/langchain",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
-  "description": "YouTube transcript search and entity resolution tools for LangChain, powered by Arcmira.",
+  "description": "YouTube transcript search for AI agents: the exact quote, often who said it, and a watch link cued to the second.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -21,7 +21,7 @@
     "test": "node --test test/*.test.mjs"
   },
   "dependencies": {
-    "arcmira": "0.6.0"
+    "arcmira": "0.6.2"
   },
   "peerDependencies": {
     "@langchain/core": "^1.2.13",
@@ -49,6 +49,7 @@
     "youtube-transcript-search",
     "youtube",
     "transcript-search",
+    "podcast-transcript-search",
     "arcmira",
     "langchain",
     "langgraph",