Grab My Files

Grab My Files

When to use

Invoke when the user says anything like:

• "export all produced files" / "package everything"
• "zip up my files" / "bundle my files"
• "give me everything you made" / "download all the outputs"

If the user names a subset ("just the PDFs", "only the report"), honor that and zip only the matching files, but still follow the rules below.

How to export

1. Inspect the folder. List /app/created/ recursively so nested outputs (e.g. /app/created/charts/foo.png) are included, not just top-level files.
2. Decide what goes in. Include every produced file except:
   • any previous export archive (files named all_files_produced_*.zip), and
   • hidden/system junk (.DS_Store, Thumbs.db, *.tmp, dotfiles).
3. Prune old exports after the new one is written. Build the new archive first, then delete any other all_files_produced_*.zip in /app/created/. Doing it in this order means a failed build never destroys the user's previous bundle, and no old export gets nested inside the new one.
4. Handle the empty case. If nothing qualifies, tell the user there are no produced files to export and stop — do not create an empty zip.
5. Name the archive all_files_produced_<YYYYMMDD_HHMMSS>.zip — a sortable, UTC timestamp — and write it to /app/created/.
6. Preserve structure. Keep the relative folder layout inside the zip so files restore to the same subfolders they came from.
7. Deliver it. Return the finished .zip to the user as a download — don't just report that it was created. In Copilot Studio, writing the file to /app/created/ surfaces it as a downloadable attachment; make sure the user gets that link.

Confirm to the user

After the zip is written, reply with:

• the archive name (including its timestamp),
• the total count of files packaged, plus a list of up to 50 packaged paths (sorted). If there are more than 50, list the first 50 and say how many additional files were included, and
• a note that the zip is attached and ready to download.

I've packaged 3 file(s) into all_files_produced_20260724_215812.zip:

• onboarding_overview.pdf
• onboarding_overview.docx
• charts/headcount.png

It's attached above and ready to download. 📦

Run this — do not improvise

This capability's deterministic implementation is a RAPP single-file agent, linked beside this file as grab_my_files_agent.py and embedded as the fenced Python below (sha256 9cc98b1c1a193e16…; a byte-exact copy is also vaulted in the capsule comment at the end of this file). On a host with sandbox execution, run the linked file directly — if it is missing, write the fence contents verbatim to grab_my_files_agent.py first:

python3 grab_my_files_agent.py '{"key": "value"}'      # arguments as one JSON object
echo '{"key": "value"}' | python3 grab_my_files_agent.py   # or on stdin
python3 grab_my_files_agent.py --tool                      # emit the JSON tool contract

Treat stdout as a tool result. If it reports missing or unresolved inputs, stop and collect them. If it returns steps, execute those steps in order exactly as returned; if it returns instructions, follow them with the supplied inputs. Otherwise use the result verbatim. Do not invent behavior beyond that output. On a host without code execution, treat the Parameters schema and the code below as the exact specification and never paraphrase a step. Never edit inside the generated markers; a converter-equipped host can instead restore the original file checksum-verified with the installed rapp-agent-converter/scripts/toast.py convert SKILL.md --to agent.

"""GrabMyFiles -- Bundle every file the agent produced in this session into a single timestamped .zip and hand it back as a download. Use when the user asks to "export all produced files", "zip my files", "package everything you made", "bundle my files", "give me all the files", or similar. Files are read from /app/created/. Do NOT use to fetch a single named file the user can already download on its own, to create or convert a file, or to save/persist files to SharePoint, OneDrive, or Dataverse — those are separate flows, not a local zip-and-download.

Generated by the rapp skill from grab-my-files. The RCI capsule at the bottom of this file carries the full original; `toast.py convert` restores it byte-exact."""

import json
import re
import sys

try:
    from agents.basic_agent import BasicAgent
except ImportError:  # running OUTSIDE a brainstem -- stay executable anyway.
    class BasicAgent:  # noqa: D101 - minimal stand-in, same contract
        def __init__(self, name=None, metadata=None):
            if name:
                self.name = name
            if metadata:
                self.metadata = metadata

        def perform(self, **kwargs):
            return "Not implemented."

        def system_context(self):
            return None

        def to_tool(self):
            return {"type": "function", "function": {
                "name": self.name,
                "description": self.metadata.get("description", ""),
                "parameters": self.metadata.get("parameters", {})}}

# The procedural layer, verbatim from the source capability.
INSTRUCTIONS = '# Grab My Files\n\n## When to use\n\nInvoke when the user says anything like:\n- "export all produced files" / "package everything"\n- "zip up my files" / "bundle my files"\n- "give me everything you made" / "download all the outputs"\n\nIf the user names a subset ("just the PDFs", "only the report"), honor that and zip\nonly the matching files, but still follow the rules below.\n\n## How to export\n\n1. **Inspect the folder.** List `/app/created/` **recursively** so nested outputs\n   (e.g. `/app/created/charts/foo.png`) are included, not just top-level files.\n2. **Decide what goes in.** Include every produced file **except**:\n   - any previous export archive (files named `all_files_produced_*.zip`), and\n   - hidden/system junk (`.DS_Store`, `Thumbs.db`, `*.tmp`, dotfiles).\n3. **Prune old exports *after* the new one is written.** Build the new archive\n   first, then delete any *other* `all_files_produced_*.zip` in `/app/created/`.\n   Doing it in this order means a failed build never destroys the user's previous\n   bundle, and no old export gets nested inside the new one.\n4. **Handle the empty case.** If nothing qualifies, tell the user there are no\n   produced files to export and stop — do not create an empty zip.\n5. **Name the archive** `all_files_produced_<YYYYMMDD_HHMMSS>.zip` — a sortable,\n   UTC timestamp — and write it to `/app/created/`.\n6. **Preserve structure.** Keep the relative folder layout inside the zip so files\n   restore to the same subfolders they came from.\n7. **Deliver it.** Return the finished `.zip` to the user as a download — don't just\n   report that it was created. In Copilot Studio, writing the file to `/app/created/`\n   surfaces it as a downloadable attachment; make sure the user gets that link.\n\n## Confirm to the user\n\nAfter the zip is written, reply with:\n- the archive name (including its timestamp),\n- the total count of files packaged, plus a list of up to 50 packaged paths (sorted). If there are more than 50, list the first 50 and say how many additional files were included, and\n- a note that the zip is attached and ready to download.\n\n> I've packaged **3 file(s)** into **`all_files_produced_20260724_215812.zip`**:\n> - `onboarding_overview.pdf`\n> - `onboarding_overview.docx`\n> - `charts/headcount.png`\n>\n> It's attached above and ready to download. 📦'

# Ordered commands lifted verbatim from the capability's own documentation.
STEPS = []


class GrabMyFilesAgent(BasicAgent):
    def __init__(self):
        self.name = 'GrabMyFiles'
        self.metadata = {
          "name": "GrabMyFiles",
          "description": "Bundle every file the agent produced in this session into a single timestamped .zip and hand it back as a download. Use when the user asks to \"export all produced files\", \"zip my files\", \"package everything you made\", \"bundle my files\", \"give me all the files\", or similar. Files are read from /app/created/. Do NOT use to fetch a single named file the user can already download on its own, to create or convert a file, or to save/persist files to SharePoint, OneDrive, or Dataverse \u2014 those are separate flows, not a local zip-and-download.",
          "parameters": {
            "type": "object",
            "properties": {},
            "required": []
          }
        }
        super().__init__(name=self.name, metadata=self.metadata)

    def perform(self, **kwargs):  # toaster:generated-perform
        return json.dumps({"status": "ok", "instructions": INSTRUCTIONS,
                           "inputs": kwargs,
                           "note": "Prose-only capability: follow INSTRUCTIONS "
                                   "with the given inputs."}, indent=2)

if __name__ == "__main__":
    #     echo '{"arg": "value"}' | python3 grab_my_files_agent.py
    #     python3 grab_my_files_agent.py '{"arg": "value"}'
    #     python3 grab_my_files_agent.py --tool          # emit the JSON tool contract
    _a = sys.argv[1:]
    if _a and _a[0] == "--tool":
        print(json.dumps(GrabMyFilesAgent().to_tool(), indent=2))
    else:
        _raw = _a[0] if _a else (sys.stdin.read().strip() or "{}")
        print(GrabMyFilesAgent().perform(**json.loads(_raw)))

# rci-capsule:v1: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