AI Agents & MCP Hub

from langchain_core.tools import tool
from srift import Srift
srift = Srift()
tool
def srift_quick_share(filePath: str) -> dict:
    """Share a local file with the user; returns a download link."""
    return srift.quick_share(filePath)

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.core.tools import FunctionTool
quick = FunctionTool.from_defaults(fn=srift.quick_share, name="srift_quick_share")
agent = FunctionAgent(tools=[quick], llm=llm)   or load the SRIFT MCP server with llama-index-tools-mcp

agent = AssistantAgent("courier", model_client=model,
  tools=[srift_quick_share])   a plain Python function, as defined for LangChain above
await Console(agent.run_stream(task="Share /tmp/x.zip"))

tool("SRIFT Quick Share")
def quick_share(file_path: str) -> str:
    return srift.quick_share(file_path)['downloadUrl']
courier = Agent(role="Courier", tools=[quick_share])

class QuickShare(dspy.Tool):
    def __init__(self): super().__init__(name="srift_quick_share", desc="...")
    def __call__(self, filePath): return srift.quick_share(filePath)
agent = dspy.ReAct("q -> a", tools=[QuickShare()])

import { generateText, tool } from "ai";
await generateText({ model: openai(MODEL),
  tools: { srift_quick_share: tool({
    description: "...",
    parameters: z.object({ filePath: z.string() }),
    execute: async ({ filePath }) => srift.quickShare(filePath),
  }) },
  prompt: "Share /tmp/x.zip" });

import { createTool } from "@mastra/core/tools";
const sriftTool = createTool({
  id: "srift_quick_share",
  inputSchema: z.object({ filePath: z.string() }),
  execute: async ({ context }) => srift.quickShare(context.filePath),
});

// HTTP Request node:
URL:    http://...:/quick-share
Method: POST
JSON:   { "filePath": "{{ $json.filePath }}" }

# Webhooks by Zapier → POST
URL:     http://...:/quick-share
Payload: { "filePath": "{{trigger.path}}" }

URL:    http://...:/quick-share
Method: POST
Body:   { "filePath": "{{1.filePath}}" }

# docker-compose.yml — daemon shares the agent's localhost
services:
  agent:
    image: your-agent-image
    environment: { SRIFT_BASE_URL: "http://127.0.0.1:3822" }
    volumes: [shared:/data]      pass /data/... paths to quick-share
  srift:
    image: srift-daemon:..    FROM node:-alpine + npm i -g srift-transfer
    network_mode: "service:agent"
    volumes: [shared:/data]      same path in both containers
volumes: { shared: {} }
# Simplest: npm i -g srift-transfer (or pip install srift) in the agent image

spec:
  containers:
  - name: agent
    image: your-agent-image
    env: [{ name: SRIFT_BASE_URL, value: "http://127.0.0.1:3822" }]
    volumeMounts: [{ name: shared, mountPath: /data }]    pass /data/... paths
  - name: srift                       same pod = same localhost
    image: srift-daemon:..2
    volumeMounts: [{ name: shared, mountPath: /data }]    same path in both
    readinessProbe:                   exec: the daemon only listens on ...1
      exec: { command: [node, -e, "require('http').get('http://127.0.0.1:3822/health',r=>process.exit(r.statusCode===200?0:1))"] }
  volumes: [{ name: shared, emptyDir: {} }]

- name: Share build
  run: |
    npx -y srift-transfer quick-share build.tar.gz --encrypt --once \
      --json --wait --wait-timeout m > srift.json &
    sleep  && jq -r .downloadUrl srift.json    post this link, then:
    wait                                         serve until downloaded

# Node.js 20+ available (or pip install srift, which bundles Node.js)
p = subprocess.Popen(["srift", "quick-share", "/tmp/report.pdf", "--once",
    "--foreground", "--wait", "--wait-timeout", "12m", "--json"],
    stdout=subprocess.PIPE, text=True)
link = json.loads(p.stdout.readline())["downloadUrl"]; notify(link); p.wait()

# In the agent image
RUN npm install -g srift-transfer
# At runtime (keep the instance alive until downloaded)
srift quick-share /tmp/report.pdf --json --wait --wait-timeout m

// Hosted MCP only: https://srift.app/mcp (9 session tools).
// File delivery needs the CLI on a machine you control;
// never expose port 3822.
return fetch("https://srift.app/mcp", { method: "POST",
  headers: { "Content-Type": "application/json", "Accept": "application/json, text/event-stream" },
  body: await req.text() });

npm install -g srift-transfer         or: pip install srift
srift quick-share ./output.zip --json     https://srift.app/d/<token>
# The daemon stays on 127.0.0.1; don't map port 3822 to the internet

vscode.commands.registerCommand("srift.share", async (uri) => {
  const r = await fetch("http://127.0.0.1:3822/quick-share", {
    method:"POST", headers:{"Content-Type":"application/json"},
    body: JSON.stringify({ filePath: uri.fsPath })
  });
  const { downloadUrl } = await r.json();   // https://srift.app/d/<token>
  vscode.env.clipboard.writeText(downloadUrl);
  vscode.window.showInformationMessage("SRIFT download link copied to clipboard");
});